String

CASE_INSENSITIVE_ORDER

Comparator<String> CASE_INSENSITIVE_ORDER

Compares strings using compareToIgnoreCase(String). This is not suitable for case-insensitive string comparison for all locales. Use a Collator instead.

String

String ()

Creates an empty string.

String

String (byte[] data)

Converts the byte array to a string using the system's default charset.

String

String (byte[] data, 
                int high)

This constructor was deprecated in API level 1.
Use String(byte[]) or String(byte[], String) instead.

Converts the byte array to a string, setting the high byte of every char to the specified value.

String

String (byte[] data, 
                int offset, 
                int byteCount)

Converts a subsequence of the byte array to a string using the system's default charset.

String

String (byte[] data, 
                int high, 
                int offset, 
                int byteCount)

This constructor was deprecated in API level 1.
Use String(byte[], int, int) instead.

Converts the byte array to a string, setting the high byte of every char to high.

String

String (byte[] data, 
                int offset, 
                int byteCount, 
                String charsetName)

Converts the byte array to a string using the named charset.

The behavior when the bytes cannot be decoded by the named charset is unspecified. Use CharsetDecoder for more control.

String

String (byte[] data, 
                String charsetName)

Converts the byte array to a string using the named charset.

The behavior when the bytes cannot be decoded by the named charset is unspecified. Use CharsetDecoder for more control.

String

String (byte[] data, 
                int offset, 
                int byteCount, 
                Charset charset)

Converts the byte array to a string using the given charset.

The behavior when the bytes cannot be decoded by the given charset is to replace malformed input and unmappable code points with the charset's default replacement string. Use CharsetDecoder for more control.

String

String (byte[] data, 
                Charset charset)

Converts the byte array to a String using the given charset.

String

String (char[] data)

Initializes this string to contain the given chars. Modifying the array after creating the string has no effect on the string.

String

String (char[] data, 
                int offset, 
                int charCount)

Initializes this string to contain the given chars. Modifying the array after creating the string has no effect on the string.

String

String (String toCopy)

Constructs a new string with the same sequence of characters as toCopy.

String

String (StringBuffer stringBuffer)

Creates a String from the contents of the specified StringBuffer.

String

String (int[] codePoints, 
                int offset, 
                int count)

Creates a String from the sub-array of Unicode code points.

String

String (StringBuilder stringBuilder)

Creates a String from the contents of the specified StringBuilder.

charAt

char charAt (int index)

Returns the char at index.

codePointAt

int codePointAt (int index)

Returns the Unicode code point at the given index.

codePointBefore

int codePointBefore (int index)

Returns the Unicode code point that precedes the given index.

codePointCount

int codePointCount (int start, 
                int end)

Calculates the number of Unicode code points between start and end.

compareTo

int compareTo (String string)

Compares this string to the given string.

The strings are compared one char at a time. In the discussion of the return value below, note that char does not mean code point, though this should only be visible for surrogate pairs.

If there is an index at which the two strings differ, the result is the difference between the two chars at the lowest such index. If not, but the lengths of the strings differ, the result is the difference between the two strings' lengths. If the strings are the same length and every char is the same, the result is 0.

compareToIgnoreCase

int compareToIgnoreCase (String string)

Compares this string to the given string, ignoring case differences.

The strings are compared one char at a time. This is not suitable for case-insensitive string comparison for all locales. Use a Collator instead.

If there is an index at which the two strings differ, the result is the difference between the two chars at the lowest such index. If not, but the lengths of the strings differ, the result is the difference between the two strings' lengths. If the strings are the same length and every char is the same, the result is 0.

concat

String concat (String string)

Concatenates this string and the specified string.

contains

boolean contains (CharSequence cs)

Returns true if this string contains the charss from the given CharSequence.

contentEquals

boolean contentEquals (CharSequence cs)

Returns true if the chars in the given CharSequence are the same as those in this string.

contentEquals

boolean contentEquals (StringBuffer sb)

Returns true if the chars in the given StringBuffer are the same as those in this string.

copyValueOf

String copyValueOf (char[] data, 
                int start, 
                int length)

Creates a new string by copying the given subsequence of the given char[]. Modifying the array after creating the string has no effect on the string.

copyValueOf

String copyValueOf (char[] data)

Creates a new string by copying the given char[]. Modifying the array after creating the string has no effect on the string.

endsWith

boolean endsWith (String suffix)

Compares the specified string to this string to determine if the specified string is a suffix.

equals

boolean equals (Object other)

Compares the given object to this string and returns true if they are equal. The object must be an instance of String with the same length, where for every index, charAt on each string returns the same value.

equalsIgnoreCase

boolean equalsIgnoreCase (String string)

Compares the given string to this string ignoring case.

The strings are compared one char at a time. This is not suitable for case-insensitive string comparison for all locales. Use a Collator instead.

format

String format (Locale locale, 
                String format, 
                Object... args)

Returns a formatted string, using the supplied format and arguments, localized to the given locale.

format

String format (String format, 
                Object... args)

Returns a localized formatted string, using the supplied format and arguments, using the user's default locale.

If you're formatting a string other than for human consumption, you should use the format(Locale, String, Object...) overload and supply Locale.US. See "Be wary of the default locale".

getBytes

void getBytes (int start, 
                int end, 
                byte[] data, 
                int index)

This method was deprecated in API level 1.
Use getBytes() or getBytes(String)

Mangles a subsequence of this string into a byte array by stripping the high order bits from each char. Use getBytes() or getBytes(String) instead.

getBytes

byte[] getBytes (String charsetName)

Returns a new byte array containing the code points of this string encoded using the named charset.

The behavior when this string cannot be represented in the named charset is unspecified. Use CharsetEncoder for more control.

getBytes

byte[] getBytes (Charset charset)

Returns a new byte array containing the code points of this string encoded using the given charset.

The behavior when this string cannot be represented in the given charset is to replace malformed input and unmappable code points with the charset's default replacement byte array. Use CharsetEncoder for more control.

getBytes

byte[] getBytes ()

Returns a new byte array containing the code points in this string encoded using the system's default charset.

The behavior when this string cannot be represented in the system's default charset is unspecified. In practice, when the default charset is UTF-8 (as it is on Android), all strings can be encoded.

getChars

void getChars (int start, 
                int end, 
                char[] buffer, 
                int index)

Copies the given subsequence of this string to the given array starting at the given offset.

hashCode

int hashCode ()

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

indexOf

int indexOf (int c)

Returns the first index of the given code point, or -1. The search starts at the beginning and moves towards the end of this string.

indexOf

int indexOf (int c, 
                int start)

Returns the next index of the given code point, or -1. The search starts at the given offset and moves towards the end of this string.

indexOf

int indexOf (String subString, 
                int start)

Returns the next index of the given string in this string, or -1. The search for the string starts at the given offset and moves towards the end of this string.

indexOf

int indexOf (String string)

Returns the first index of the given string, or -1. The search starts at the beginning and moves towards the end of this string.

intern

String intern ()

Returns an interned string equal to this string. The VM maintains an internal set of unique strings. All string literals found in loaded classes' constant pools are automatically interned. Manually-interned strings are only weakly referenced, so calling intern won't lead to unwanted retention.

Interning is typically used because it guarantees that for interned strings a and b, a.equals(b) can be simplified to a == b. (This is not true of non-interned strings.)

Many applications find it simpler and more convenient to use an explicit HashMap to implement their own pools.

isEmpty

boolean isEmpty ()

Returns true if the length of this string is 0.

lastIndexOf

int lastIndexOf (String string)

Returns the index of the start of the last match for the given string in this string, or -1. The search for the string starts at the end and moves towards the beginning of this string.

lastIndexOf

int lastIndexOf (int c, 
                int start)

Returns the last index of the code point c, or -1. The search starts at offset start and moves towards the beginning of this string.

lastIndexOf

int lastIndexOf (int c)

Returns the last index of the code point c, or -1. The search starts at the end and moves towards the beginning of this string.

lastIndexOf

int lastIndexOf (String subString, 
                int start)

Returns the index of the start of the previous match for the given string in this string, or -1. The search for the string starts at the given index and moves towards the beginning of this string.

length

int length ()

Returns the number of chars in this string. If this string contains surrogate pairs, this is not the same as the number of code points.

matches

boolean matches (String regularExpression)

Tests whether this string matches the given regularExpression. This method returns true only if the regular expression matches the entire input string. A common mistake is to assume that this method behaves like contains(CharSequence); if you want to match anywhere within the input string, you need to add .* to the beginning and end of your regular expression. See matches(String, CharSequence).

If the same regular expression is to be used for multiple operations, it may be more efficient to reuse a compiled Pattern.

offsetByCodePoints

int offsetByCodePoints (int index, 
                int codePointOffset)

Returns the index within this object that is offset from index by codePointOffset code points.

regionMatches

boolean regionMatches (boolean ignoreCase, 
                int thisStart, 
                String string, 
                int start, 
                int length)

Returns true if the given subsequence of the given string matches this string starting at the given offset.

If ignoreCase is true, case is ignored during the comparison. The strings are compared one char at a time. This is not suitable for case-insensitive string comparison for all locales. Use a Collator instead.

regionMatches

boolean regionMatches (int thisStart, 
                String string, 
                int start, 
                int length)

Returns true if the given subsequence of the given string matches this string starting at the given offset.

replace

String replace (CharSequence target, 
                CharSequence replacement)

Returns a copy of this string after replacing occurrences of target replaced with replacement. The string is processed from the beginning to the end.

replace

String replace (char oldChar, 
                char newChar)

Returns a copy of this string after replacing occurrences of the given char with another.

replaceAll

String replaceAll (String regularExpression, 
                String replacement)

Replaces all matches for regularExpression within this string with the given replacement. See Pattern for regular expression syntax.

If the same regular expression is to be used for multiple operations, it may be more efficient to reuse a compiled Pattern.

replaceFirst

String replaceFirst (String regularExpression, 
                String replacement)

Replaces the first match for regularExpression within this string with the given replacement. See Pattern for regular expression syntax.

If the same regular expression is to be used for multiple operations, it may be more efficient to reuse a compiled Pattern.

split

String[] split (String regularExpression)

Splits this string using the supplied regularExpression. Equivalent to split(regularExpression, 0). See split(CharSequence, int) for an explanation of limit. See Pattern for regular expression syntax.

If the same regular expression is to be used for multiple operations, it may be more efficient to reuse a compiled Pattern.

split

String[] split (String regularExpression, 
                int limit)

Splits this string using the supplied regularExpression. See split(CharSequence, int) for an explanation of limit. See Pattern for regular expression syntax.

If the same regular expression is to be used for multiple operations, it may be more efficient to reuse a compiled Pattern.

startsWith

boolean startsWith (String prefix)

Compares the specified string to this string to determine if the specified string is a prefix.

startsWith

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.

subSequence

CharSequence subSequence (int start, 
                int end)

Equivalent to substring(int, int) but needed to implement CharSequence.

substring

String substring (int start)

Returns a string containing a suffix of this string starting at start. The returned string shares this string's backing array.

substring

String substring (int start, 
                int end)

Returns a string containing the given subsequence of this string. The returned string shares this string's backing array.

toCharArray

char[] toCharArray ()

Returns a new char array containing a copy of the chars in this string. This is expensive and rarely useful. If you just want to iterate over the chars in the string, use charAt(int) instead.

toLowerCase

String toLowerCase (Locale locale)

Converts this string to lower case, using the rules of locale.

Most case mappings are unaffected by the language of a Locale. Exceptions include dotted and dotless I in Azeri and Turkish locales, and dotted and dotless I and J in Lithuanian locales. On the other hand, it isn't necessary to provide a Greek locale to get correct case mapping of Greek characters: any locale will do.

See http://www.unicode.org/Public/UNIDATA/SpecialCasing.txt for full details of context- and language-specific special cases.

toLowerCase

String toLowerCase ()

Converts this string to lower case, using the rules of the user's default locale. See "Be wary of the default locale".

toString

String toString ()

Returns this string.

toUpperCase

String toUpperCase (Locale locale)

Converts this this string to upper case, using the rules of locale.

Most case mappings are unaffected by the language of a Locale. Exceptions include dotted and dotless I in Azeri and Turkish locales, and dotted and dotless I and J in Lithuanian locales. On the other hand, it isn't necessary to provide a Greek locale to get correct case mapping of Greek characters: any locale will do.

See http://www.unicode.org/Public/UNIDATA/SpecialCasing.txt for full details of context- and language-specific special cases.

toUpperCase

String toUpperCase ()

Converts this this string to upper case, using the rules of the user's default locale. See "Be wary of the default locale".

trim

String trim ()

Returns a string with no code points <= \\u0020 at the beginning or end.

valueOf

String valueOf (long value)

Returns the string representation of the given long.

valueOf

String valueOf (Object value)

Converts the specified object to its string representation. If the object is null return the string "null", otherwise use toString() to get the string representation.

valueOf

String valueOf (char[] data)

Returns a new string containing the same chars as the given array. Modifying the array after creating the string has no effect on the string.

valueOf

String valueOf (double value)

Returns the string representation of the given double.

valueOf

String valueOf (int value)

Returns the string representation of the given int.

valueOf

String valueOf (float value)

Returns the string representation of the given float.

valueOf

String valueOf (char[] data, 
                int start, 
                int length)

Returns a new string containing the same chars as the given subset of the given array. Modifying the array after creating the string has no effect on the string.

valueOf

String valueOf (boolean value)

Converts the specified boolean to its string representation. When the boolean is true return "true", otherwise return "false".

valueOf

String valueOf (char value)

Returns a new string of just the given char.