java.lang.Object | ||
java.lang.String | Serializable CharSequence Comparable<T> |
An immutable sequence of characters/code units (char
s). A
String
is represented by array of UTF-16 values, such that
Unicode supplementary characters (code points) are stored/encoded as
surrogate pairs via Unicode code units (char
)
Value | ||||
---|---|---|---|---|
Comparator<String> | CASE_INSENSITIVE_ORDER |
String() | ||||||
Returns an empty string. | ||||||
String(byte[] data) | ||||||
Converts the byte array to a String using the default encoding as specified by the file.encoding system property. | ||||||
String(byte[] data, int high) | ||||||
This constructor is deprecated. Use String(byte[]) or String(byte[], String) instead | ||||||
String(byte[] data, int start, int length) | ||||||
Converts the byte array to a String using the default encoding as specified by the file.encoding system property. | ||||||
String(byte[] data, int high, int start, int length) | ||||||
This constructor is deprecated. Use String(byte[], int, int) instead | ||||||
String(byte[] data, int start, int length, String encoding) | ||||||
Converts the byte array to a String using the specified encoding. | ||||||
String(byte[] data, String encoding) | ||||||
Converts the byte array to a String using the specified encoding. | ||||||
String(char[] data) | ||||||
Initializes this String to contain the characters in the specified character array. | ||||||
String(char[] data, int start, int length) | ||||||
Initializes this String to contain the specified characters in the character array. | ||||||
String(String string) | ||||||
Creates a string that is a copy of another string | ||||||
String(StringBuffer stringbuffer) | ||||||
Creates a string from the contents of a StringBuffer. | ||||||
String(int[] codePoints, int offset, int count) | ||||||
Constructs a |
||||||
String(StringBuilder sb) | ||||||
Constructs a |
char | charAt(int index) | |||||
Returns the character at the specified offset in this String. | ||||||
int | codePointAt(int index) | |||||
Retrieves the Unicode code point value at the |
||||||
int | codePointBefore(int index) | |||||
Retrieves the Unicode code point value that precedes the
|
||||||
int | codePointCount(int beginIndex, int endIndex) | |||||
Calculates the number of Unicode code points between
|
||||||
int | compareTo(String string) | |||||
Compares the specified String to this String using the Unicode values of the characters. | ||||||
int | compareToIgnoreCase(String string) | |||||
Compare the receiver to the specified String to determine the relative ordering when the case of the characters is ignored. | ||||||
String | concat(String string) | |||||
Concatenates this String and the specified string. | ||||||
boolean | contains(CharSequence cs) | |||||
Determines if this |
||||||
boolean | contentEquals(StringBuffer strbuf) | |||||
Returns whether the characters in the StringBuffer strbuf are the same as those in this String. | ||||||
boolean | contentEquals(CharSequence cs) | |||||
Compares a |
||||||
static | String | copyValueOf(char[] data) | ||||
Creates a new String containing the characters in the specified character array. | ||||||
static | String | copyValueOf(char[] data, int start, int length) | ||||
Creates a new String containing the specified characters in the character array. | ||||||
boolean | endsWith(String suffix) | |||||
Compares the specified string to this String to determine if the specified string is a suffix. | ||||||
boolean | equals(Object object) | |||||
Compares the specified object to this String and returns true if they are equal. | ||||||
boolean | equalsIgnoreCase(String string) | |||||
Compares the specified String to this String ignoring the case of the characters and returns true if they are equal. | ||||||
static | String | format(String format, Object[] args) | ||||
Returns a printf-style formatted string, using the supplied format and arguments. | ||||||
static | String | format(Locale loc, String format, Object[] args) | ||||
Returns a printf-style formatted string, using the supplied format and arguments, accordingly to the specified locale. | ||||||
void | getBytes(int start, int end, byte[] data, int index) | |||||
This method is deprecated. Use getBytes() or getBytes(String) | ||||||
byte[] | getBytes() | |||||
Converts this String to a byte encoding using the default encoding as specified by the file.encoding system property. | ||||||
byte[] | getBytes(String encoding) | |||||
Converts this String to a byte encoding using the specified encoding. | ||||||
void | getChars(int start, int end, char[] buffer, int index) | |||||
Copies the specified characters in this String to the character array starting at the specified offset in the character array. | ||||||
int | hashCode() | |||||
Returns an integer hash code for the receiver. | ||||||
int | indexOf(int c, int start) | |||||
Searches in this String for the index of the specified character. | ||||||
int | indexOf(int c) | |||||
Searches in this String for the first index of the specified character. | ||||||
int | indexOf(String subString, int start) | |||||
Searches in this String for the index of the specified string. | ||||||
int | indexOf(String string) | |||||
Searches in this String for the first index of the specified string. | ||||||
String | intern() | |||||
Searches an internal table of strings for a string equal to this String. | ||||||
int | lastIndexOf(int c) | |||||
Searches in this String for the last index of the specified character. | ||||||
int | lastIndexOf(String string) | |||||
Searches in this String for the last index of the specified string. | ||||||
int | lastIndexOf(String subString, int start) | |||||
Searches in this String for the index of the specified string. | ||||||
int | lastIndexOf(int c, int start) | |||||
Searches in this String for the index of the specified character. | ||||||
int | length() | |||||
Returns the size of this String. | ||||||
boolean | matches(String expr) | |||||
Determines whether a this String matches a given regular expression. | ||||||
int | offsetByCodePoints(int index, int codePointOffset) | |||||
Returns the index within this object that is offset from
|
||||||
boolean | regionMatches(int thisStart, String string, int start, int length) | |||||
Compares the specified string to this String and compares the specified range of characters to determine if they are the same. | ||||||
boolean | regionMatches(boolean ignoreCase, int thisStart, String string, int start, int length) | |||||
Compares the specified string to this String and compares the specified range of characters to determine if they are the same. | ||||||
String | replace(char oldChar, char newChar) | |||||
Copies this String replacing occurrences of the specified character with another character. | ||||||
String | replace(CharSequence target, CharSequence replacement) | |||||
Copies this String replacing occurrences of the specified target sequence with another sequence. | ||||||
String | replaceAll(String expr, String substitute) | |||||
Replace any substrings within this String that match the supplied regular expression expr, with the String substitute. | ||||||
String | replaceFirst(String expr, String substitute) | |||||
Replace the first substring within this String that matches the supplied regular expression expr, with the String substitute. | ||||||
String[] | split(String expr, int max) | |||||
Splits this String using the supplied regular expression expr. | ||||||
String[] | split(String expr) | |||||
Splits this String using the supplied regular expression expr. | ||||||
boolean | startsWith(String prefix, int start) | |||||
Compares the specified string to this String, starting at the specified offset, to determine if the specified string is a prefix. | ||||||
boolean | startsWith(String prefix) | |||||
Compares the specified string to this String to determine if the specified string is a prefix. | ||||||
CharSequence | subSequence(int start, int end) | |||||
Has the same result as the substring function, but is present so that String may implement the CharSequence interface. | ||||||
String | substring(int start, int end) | |||||
Copies a range of characters into a new String. | ||||||
String | substring(int start) | |||||
Copies a range of characters into a new String. | ||||||
char[] | toCharArray() | |||||
Copies the characters in this String to a character array. | ||||||
String | toLowerCase(Locale locale) | |||||
Converts the characters in this String to lowercase, using the specified Locale. | ||||||
String | toLowerCase() | |||||
Converts the characters in this String to lowercase, using the default Locale. | ||||||
String | toString() | |||||
Returns a string containing a concise, human-readable description of the receiver. | ||||||
String | toUpperCase(Locale locale) | |||||
Converts the characters in this String to uppercase, using the specified Locale. | ||||||
String | toUpperCase() | |||||
Converts the characters in this String to uppercase, using the default Locale. | ||||||
String | trim() | |||||
Copies this String removing white space characters from the beginning and end of the string. | ||||||
static | String | valueOf(float value) | ||||
Converts the specified float to its string representation. | ||||||
static | String | valueOf(boolean value) | ||||
Converts the specified boolean to its string representation. | ||||||
static | String | valueOf(double value) | ||||
Converts the specified double to its string representation. | ||||||
static | String | valueOf(char value) | ||||
Converts the specified character to its string representation. | ||||||
static | String | valueOf(char[] data) | ||||
Creates a new String containing the characters in the specified character array. | ||||||
static | String | valueOf(char[] data, int start, int length) | ||||
Creates a new String containing the specified characters in the character array. | ||||||
static | String | valueOf(long value) | ||||
Converts the specified long to its string representation. | ||||||
static | String | valueOf(int value) | ||||
Converts the specified integer to its string representation. | ||||||
static | String | valueOf(Object value) | ||||
Converts the specified object to its string representation. |
data | the byte array to convert to a String |
---|
NullPointerException | when data is null |
---|
This constructor is deprecated. Use String(byte[]) or String(byte[], String) instead
Converts the byte array to a String, setting the high byte of every character to the specified value.data | the byte array to convert to a String |
---|---|
high | the high byte to use |
NullPointerException | when data is null |
---|
data | the byte array to convert to a String |
---|---|
start | the starting offset in the byte array |
length | the number of bytes to convert |
IndexOutOfBoundsException | when length < 0, start < 0 or
start + length > data.length |
---|---|
NullPointerException | when data is null |
This constructor is deprecated. Use String(byte[], int, int) instead
Converts the byte array to a String, setting the high byte of every character to the specified value.data | the byte array to convert to a String |
---|---|
high | the high byte to use |
start | the starting offset in the byte array |
length | the number of bytes to convert |
IndexOutOfBoundsException | when length < 0, start < 0 or
start + length > data.length |
---|---|
NullPointerException | when data is null |
data | the byte array to convert to a String |
---|---|
start | the starting offset in the byte array |
length | the number of bytes to convert |
encoding | the encoding |
IndexOutOfBoundsException | when length < 0, start < 0 or
start + length > data.length |
---|---|
UnsupportedEncodingException | when encoding is not supported |
NullPointerException | when data is null |
data | the byte array to convert to a String |
---|---|
encoding | the encoding |
UnsupportedEncodingException | when encoding is not supported |
---|---|
NullPointerException | when data is null |
data | the array of characters |
---|
NullPointerException | when data is null |
---|
data | the array of characters |
---|---|
start | the starting offset in the character array |
length | the number of characters to use |
IndexOutOfBoundsException | when length < 0, start < 0 or
start + length > data.length |
---|---|
NullPointerException | when data is null |
string | the String to copy |
---|
stringbuffer | the StringBuffer |
---|
Constructs a String
from the sub-array of Unicode code
points.
codePoints | The array of Unicode code points to convert. |
---|---|
offset | The inclusive index into codePoints to begin
converting from. |
count | The number of element in codePoints to copy. |
NullPointerException | if codePoints is null. |
---|---|
IllegalArgumentException | if any of the elements of codePoints are not
valid Unicode code points. |
IndexOutOfBoundsException | if offset or count are not
within the bounds of codePoints . |
Constructs a String
from a StringBuilder
.
sb | The StringBuilder to copy from. |
---|
NullPointerException | if sb is null . |
---|
index | the zero-based index in this string |
---|
IndexOutOfBoundsException | when index < 0 or
index >= length()
|
---|
Retrieves the Unicode code point value at the index
.
index | The index to the char code unit within this
object. |
---|
IndexOutOfBoundsException | if index is negative or greater than or equal
to length(). |
---|
Retrieves the Unicode code point value that precedes the
index
.
index | The index to the char code unit within this
object. |
---|
IndexOutOfBoundsException | if index is less than 1 or greater than
length(). |
---|
Calculates the number of Unicode code points between
beginIndex
and endIndex
.
beginIndex | The inclusive beginning index of the subsequence. |
---|---|
endIndex | The exclusive end index of the subsequence. |
IndexOutOfBoundsException | if beginIndex is negative or greater than
endIndex or endIndex is greater
than length(). |
---|
string | the string to compare |
---|
NullPointerException | when string is null |
---|
string | a String |
---|
string | the string to concatenate |
---|
NullPointerException | if string is null |
---|
Determines if this String
contains the sequence of
characters in the CharSequence
passed.
cs | The character sequence to search for. |
---|
true
if the sequence of characters are contained
in this object; otherwise false
strbuf | the StringBuffer to compare this String to |
---|
NullPointerException | when strbuf is null |
---|
Compares a CharSequence
to this String
to
determine if their contents are equal.
cs | The character sequence to compare to. |
---|
true
if equal, otherwise false
data | the array of characters |
---|
NullPointerException | if data is null |
---|
data | the array of characters |
---|---|
start | the starting offset in the character array |
length | the number of characters to use |
IndexOutOfBoundsException | if length < 0, start < 0 or
start + length > data.length |
---|---|
NullPointerException | if data is null |
suffix | the string to look for |
---|
NullPointerException | if suffix is null |
---|
object | the object to compare |
---|
string | the string to compare |
---|
format(Locale.getDefault(), format, args)
.
format | a format string |
---|---|
args | arguments to replace format specifiers, may be none |
NullPointerException | if the format is null |
---|---|
IllegalArgumentException | if the format is invalid |
Note that this is a convenience method. Using it involves creating an internal Formatter instance on-the-fly, which is somewhat costly in terms of memory and time. This is probably acceptable if you use the method only rarely, but if you rely on it for formatting a large number of strings, consider creating and reusing your own Formatter instance instead.
loc | the locale to apply; null value means no
localization |
---|---|
format | a format string |
args | arguments to replace format specifiers, may be none |
NullPointerException | if the format is null |
---|---|
IllegalArgumentException | if the format is invalid |
This method is deprecated. Use getBytes() or getBytes(String)
Converts this String to a byte array, ignoring the high order bits of each character.start | the starting offset of characters to copy |
---|---|
end | the ending offset of characters to copy |
data | the destination byte array |
index | the starting offset in the byte array |
NullPointerException | when data is null |
---|---|
IndexOutOfBoundsException | when
start < 0, end > length(), index < 0, end - start > data.length - index |
encoding | the encoding |
---|
UnsupportedEncodingException | when the encoding is not supported |
---|
start | the starting offset of characters to copy |
---|---|
end | the ending offset of characters to copy |
buffer | the destination character array |
index | the starting offset in the character array |
IndexOutOfBoundsException | when start < 0, end > length(),
start > end, index < 0, end - start > buffer.length - index |
---|---|
NullPointerException | when buffer is null |
c | the character to find |
---|---|
start | the starting offset |
c | the character to find |
---|
subString | the string to find |
---|---|
start | the starting offset |
NullPointerException | when string is null |
---|
string | the string to find |
---|
NullPointerException | when string is null |
---|
c | the character to find |
---|
string | the string to find |
---|
NullPointerException | when string is null |
---|
subString | the string to find |
---|---|
start | the starting offset |
NullPointerException | when string is null |
---|
c | the character to find |
---|---|
start | the starting offset |
expr | the regular expression to be matched |
---|
PatternSyntaxException | if the syntax of the supplied regular expression is not valid |
---|---|
NullPointerException | if expr is null |
Returns the index within this object that is offset from
index
by codePointOffset
code points.
index | The index within this object to calculate the offset from. |
---|---|
codePointOffset | The number of code points to count. |
IndexOutOfBoundsException | if index is negative or greater than
length() or if there aren't enough code points
before or after index to match
codePointOffset . |
---|
thisStart | the starting offset in this String |
---|---|
string | the string to compare |
start | the starting offset in string |
length | the number of characters to compare |
NullPointerException | when string is null |
---|
ignoreCase | specifies if case should be ignored |
---|---|
thisStart | the starting offset in this String |
string | the string to compare |
start | the starting offset in string |
length | the number of characters to compare |
NullPointerException | when string is null |
---|
oldChar | the character to replace |
---|---|
newChar | the replacement character |
target | the sequence to replace |
---|---|
replacement | the replacement sequence |
NullPointerException | if either of the arguments
is null
|
---|
expr | the regular expression to match |
---|---|
substitute | the string to replace the matching substring with |
NullPointerException | if expr is null |
---|
expr | the regular expression to match |
---|---|
substitute | the string to replace the matching substring with |
NullPointerException | if expr is null |
---|
expr | the regular expression used to divide the string |
---|---|
max | the number of times to apply the pattern |
NullPointerException | if expr is null |
---|
expr | the regular expression used to divide the string |
---|
NullPointerException | if expr is null |
---|
prefix | the string to look for |
---|---|
start | the starting offset |
NullPointerException | when prefix is null |
---|
prefix | the string to look for |
---|
NullPointerException | when prefix is null |
---|
start | the offset the first character |
---|---|
end | the offset of one past the last character to include |
IndexOutOfBoundsException | when start or end is less than zero, start is greater than end, or end is greater than the length of the String. |
---|
start | the offset of the first character |
---|---|
end | the offset one past the last character |
IndexOutOfBoundsException | when start < 0, start > end or
end > length()
|
---|
start | the offset of the first character |
---|
IndexOutOfBoundsException | when start < 0 or
start > length()
|
---|
locale | the Locale |
---|
locale | the Locale |
---|
<= \\u0020
removed
from the beginning and the end
value | the float |
---|
"true"
, otherwise return
"false"
.
value | the boolean |
---|
value | the double |
---|
value | the character |
---|
data | the array of characters |
---|
NullPointerException | when data is null |
---|
data | the array of characters |
---|---|
start | the starting offset in the character array |
length | the number of characters to use |
IndexOutOfBoundsException | when length < 0, start < 0 or
start + length > data.length |
---|---|
NullPointerException | when data is null |
value | the long |
---|
value | the integer |
---|
Copyright 2007 Google Inc. | Build 0.9_r1-98467 - 14 Aug 2008 18:48 |