public final class String extends Object implements CharSequence, Comparable<String>
Modifier and Type | Field and Description |
---|---|
static Comparator<String> |
CASE_INSENSITIVE_ORDER |
Constructor and Description |
---|
String()
Initializes a newly created String object so that it represents an empty character sequence.
|
String(byte[] bytes)
Construct a new String by converting the specified array of bytes using the platform's default character encoding.
|
String(byte[] bytes,
Charset charset)
Construct a new String by converting the specified array of bytes using the specified character encoding.
|
String(byte[] bytes,
int off,
int len)
Construct a new String by converting the specified subarray of bytes using the platform's default character encoding.
|
String(byte[] bytes,
int off,
int len,
String enc)
Construct a new String by converting the specified subarray of bytes using the specified character encoding.
|
String(byte[] bytes,
String enc)
Construct a new String by converting the specified array of bytes using the specified character encoding.
|
String(char[] value)
Allocates a new String so that it represents the sequence of characters currently contained in the character array argument.
|
String(char[] value,
int offset,
int count)
Allocates a new String that contains characters from a subarray of the character array argument.
|
String(String value)
Initializes a newly created String object so that it represents the same sequence of characters as the argument; in other words, the newly created string is a copy of the argument string.
|
String(StringBuffer buffer)
Allocates a new string that contains the sequence of characters currently contained in the string buffer argument.
|
String(StringBuilder buffer) |
Modifier and Type | Method and Description |
---|---|
char |
charAt(int index)
Returns the character at the specified index.
|
int |
compareTo(String anotherString)
Compares two strings lexicographically.
|
int |
compareToIgnoreCase(String anotherString) |
String |
concat(String str)
Concatenates the specified string to the end of this string.
|
boolean |
contains(CharSequence seq)
Checks if string contains the given char sequence.
|
boolean |
contentEquals(CharSequence cs) |
boolean |
contentEquals(StringBuffer sb) |
static String |
copyValueOf(char[] data) |
static String |
copyValueOf(char[] data,
int offset,
int count) |
boolean |
endsWith(String suffix)
Tests if this string ends with the specified suffix.
|
boolean |
equals(Object anObject)
Compares this string to the specified object.
|
boolean |
equalsIgnoreCase(String anotherString)
Compares this String to another String, ignoring case considerations.
|
byte[] |
getBytes()
Convert this String into bytes according to the platform's default character encoding, storing the result into a new byte array.
|
byte[] |
getBytes(Charset charset)
Convert this String into bytes according to the specified character encoding, storing the result into a new byte array.
|
byte[] |
getBytes(String enc)
Convert this String into bytes according to the specified character encoding, storing the result into a new byte array.
|
void |
getChars(int srcBegin,
int srcEnd,
char[] dst,
int dstBegin)
Copies characters from this string into the destination character array.
|
int |
hashCode()
Returns a hashcode for this string.
|
int |
indexOf(int ch)
Returns the index within this string of the first occurrence of the specified character.
|
int |
indexOf(int ch,
int fromIndex)
Returns the index within this string of the first occurrence of the specified character, starting the search at the specified index.
|
int |
indexOf(String str)
Returns the index within this string of the first occurrence of the specified substring.
|
int |
indexOf(String str,
int fromIndex)
Returns the index within this string of the first occurrence of the specified substring, starting at the specified index.
|
String |
intern()
Returns a canonical representation for the string object.
|
boolean |
isEmpty()
Checks if string is empty.
|
int |
lastIndexOf(int ch)
Returns the index within this string of the last occurrence of the specified character.
|
int |
lastIndexOf(int ch,
int fromIndex)
Returns the index within this string of the last occurrence of the specified character, searching backward starting at the specified index.
|
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 |
length()
Returns the length of this string.
|
boolean |
regionMatches(boolean ignoreCase,
int toffset,
String other,
int ooffset,
int len)
Tests if two string regions are equal.
|
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.
|
String |
replace(char oldChar,
char newChar)
Returns a new string resulting from replacing all occurrences of oldChar in this string with newChar.
|
boolean |
startsWith(String prefix)
Tests if this string starts with the specified prefix.
|
boolean |
startsWith(String prefix,
int toffset)
Tests if this string starts with the specified prefix beginning at the specified index.
|
CharSequence |
subSequence(int start,
int end)
Returns a
CharSequence from the start index (inclusive)
to the end index (exclusive) of this sequence. |
String |
substring(int beginIndex)
Returns a new string that is a substring of this string.
|
String |
substring(int beginIndex,
int endIndex)
Returns a new string that is a substring of this string.
|
char[] |
toCharArray()
Converts this string to a new character array.
|
String |
toLowerCase()
Converts all of the characters in this String to lower case.
|
String |
toString()
This object (which is already a string!) is itself returned.
|
String |
toUpperCase()
Converts all of the characters in this String to upper case.
|
String |
toUpperCase(Locale locale) |
String |
trim()
Removes white space from both ends of this string.
|
static String |
valueOf(boolean b)
Returns the string representation of the boolean argument.
|
static String |
valueOf(char c)
Returns the string representation of the char argument.
|
static String |
valueOf(char[] data,
int offset,
int count)
Returns the string representation of a specific subarray of the char array argument.
|
static String |
valueOf(double d)
Returns the string representation of the double argument.
|
static String |
valueOf(float f)
Returns the string representation of the float argument.
|
static String |
valueOf(int i)
Returns the string representation of the int argument.
|
static String |
valueOf(long l)
Returns the string representation of the long argument.
|
static String |
valueOf(Object obj)
Returns the string representation of the Object argument.
|
public static final Comparator<String> CASE_INSENSITIVE_ORDER
public String()
public String(byte[] bytes)
public String(byte[] bytes, int off, int len)
public String(byte[] bytes, int off, int len, String enc) throws UnsupportedEncodingException
UnsupportedEncodingException
public String(byte[] bytes, Charset charset) throws UnsupportedEncodingException
UnsupportedEncodingException
public String(byte[] bytes, String enc) throws UnsupportedEncodingException
UnsupportedEncodingException
public String(char[] value)
public String(char[] value, int offset, int count)
public String(String value)
public String(StringBuffer buffer)
public String(StringBuilder buffer)
public char charAt(int index)
charAt
in interface CharSequence
index
- the index of the character to return.public int compareTo(String anotherString)
compareTo
in interface Comparable<String>
anotherString
- the object to compare to this instance.another
;
a positive integer if this instance is greater than
another
; 0 if this instance has the same order as
another
.public int compareToIgnoreCase(String anotherString)
public boolean contentEquals(CharSequence cs)
public boolean contentEquals(StringBuffer sb)
public static String copyValueOf(char[] data)
public static String copyValueOf(char[] data, int offset, int count)
public String concat(String str)
public boolean endsWith(String suffix)
public boolean equals(Object anObject)
public boolean equalsIgnoreCase(String anotherString)
public byte[] getBytes()
public byte[] getBytes(String enc) throws UnsupportedEncodingException
UnsupportedEncodingException
public byte[] getBytes(Charset charset) throws UnsupportedEncodingException
UnsupportedEncodingException
public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
public int hashCode()
public int indexOf(int ch)
public int indexOf(int ch, int fromIndex)
public int indexOf(String str)
public int indexOf(String str, int fromIndex)
public String intern()
public int lastIndexOf(int ch)
public int lastIndexOf(int ch, int fromIndex)
public int lastIndexOf(String string)
string
- the string to find.NullPointerException
- if string
is null
.public int lastIndexOf(String subString, int start)
subString
- the string to find.start
- the starting offset.NullPointerException
- if subString
is null
.public int length()
length
in interface CharSequence
public boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)
public String replace(char oldChar, char newChar)
public boolean startsWith(String prefix)
public boolean startsWith(String prefix, int toffset)
public String substring(int beginIndex)
public String substring(int beginIndex, int endIndex)
public char[] toCharArray()
public String toLowerCase()
public String toString()
toString
in interface CharSequence
toString
in class Object
public String toUpperCase()
public String trim()
public static String valueOf(boolean b)
public static String valueOf(char c)
public static String valueOf(char[] data, int offset, int count)
public static String valueOf(double d)
public static String valueOf(float f)
public static String valueOf(int i)
public static String valueOf(long l)
public static String valueOf(Object obj)
public CharSequence subSequence(int start, int end)
CharSequence
CharSequence
from the start
index (inclusive)
to the end
index (exclusive) of this sequence.subSequence
in interface CharSequence
start
- the start offset of the sub-sequence. It is inclusive, that
is, the index of the first character that is included in the
sub-sequence.end
- the end offset of the sub-sequence. It is exclusive, that is,
the index of the first character after those that are included
in the sub-sequencepublic boolean contains(CharSequence seq)
seq
- The charsequence to checkpublic boolean isEmpty()
public boolean regionMatches(int thisStart, String string, int start, int length)
thisStart
- the starting offset in this string.string
- the string to compare.start
- the starting offset in the specified string.length
- the number of characters to compare.true
if the ranges of characters are equal, false
otherwiseNullPointerException
- if string
is null
.