方法

length

 public int length()

返回该字符串的长度。 长度等于字符串中的 16-bit 的 Unicode 字符的数量。

返回:

该对象代表的字符序列的长度。

charAt

 public char charAt(int index)

返回指定索引处的字符。 索引范围 从 0 到 length() - 1 。

参数：

index - 字符的索引。

返回:

该字符串指定位置的字符。 第一个字符在索引 0 处。

抛出： StringIndexOutOfBoundsException

如果索引超出了范围。

getChars

 public void getChars(int srcBegin,
                      int srcEnd,
                      char dst[],
                      int dstBegin)

从该字符串中拷贝字符到目的字符数组中。

第一个要复制的字符在索引 srcBegin 处； 最后一个要复制的字符在索引 srcEnd-1 处(因此要复制的字符总数就是 srcEnd-srcBegin) 。要复制到 dst 子数组的字符开始于索引 dstBegin ，结束于索引：

     dstbegin + (srcEnd-srcBegin) - 1
 

参数：

srcBegin - 要复制的字符串中第一个字符的索引。

srcEnd - 要复制的字符串中最后一个字符的索引。

dst - 目标数组。

dstBegin - 目标数组中的开始偏移量。

抛出： StringIndexOutOfBoundsException

如果 srcBegin 或 srcEnd 超出了范围，或如果 srcBegin 大于 srcEnd 。

getBytes

 public void getBytes(int srcBegin,
                      int srcEnd,
                      byte dst[],
                      int dstBegin)

注意：不推荐使用 getBytes() 方法。 该方法不适当地把字符转换成字节。同 JDK 1.1 类似，完成此操作的首选方法是采用 getBytes(String enc) 方法， 它使用一个字符-编码方式名作参数，或使用 getBytes() 方法，它使用平台的缺省编码方式。

从该字符串拷贝字符到目的字节数组中。 每个字节接收对应字符的低8位。

第一个要复制的字符在索引 srcBegin 处； 最后一个要复制的字符在索引 srcEnd-1 处。要复制的字符总数是 srcEnd-srcBegin 。字符被转换成字节复制到 dst 子数组。它开始于索引 dstBegin ，结束于索引：

     dstbegin + (srcEnd-srcBegin) - 1
 

参数：

srcBegin - 要复制的字符串中第一个字符的索引。

srcEnd - 要复制的字符串中最后一个字符的索引。

dst - 目标数组。

dstBegin - 目标数组中的开始偏移量。

抛出： StringIndexOutOfBoundsException

如果 srcBegin 或 srcEnd 超出了范围，或如果 srcBegin 大于 srcEnd 。

getBytes

 public byte[] getBytes(String enc) throws UnsupportedEncodingException

按照指定的字符编码方式把该 String转换为字节，结果存到一个新的字节数组中。

参数：

enc - 一个字符-编码名称

返回:

结果的字节数组

抛出： UnsupportedEncodingException

如果不支持该编码方式

getBytes

 public byte[] getBytes()

按照平台缺省的字符编码方式把该 String 转换成字节，并把结果存到一新的字节数组中。

返回:

作为结果的字节数组

equals

 public boolean equals(Object anObject)

比较该字符串和指定的对象。当且仅当参数不为 null ，且是一个 String 对象，它表示的字符序列与此对象相同时结果为 true 。

参数：

anObject - 要同该 String 作比较的对象。

返回:

如果和 String 相等则为 true ；否则为 false 。

覆盖:

类 Object 中的 equals

参见:

compareTo, equalsIgnoreCase

equalsIgnoreCase

 public boolean equalsIgnoreCase(String anotherString)

比较该字符串和另一个对象。 当且仅当参数不为 null ，且是一个String 对象，它所表示的字符序列在大小写被忽略时与此对象相同，则结果为 true 。

如果至少满足以下条件之一，则两个字符在忽略大小写时被认为是相等的：

• 两个字符是相同的 (通过 == 运算符比较)。
• 对每个字符应用方法 Character.toUppercase ，产生的结果相同。
• 对每个字符应用方法 Character.toLowercase ，产生的结果相同。

如果两个字符序列有相同的长度且对应的字符在忽略大小写时相同，，则两个字符序列被认为是相等的。

参数：

anotherString - 要同该 String 相比较的 String 。

返回:

忽略大小写时，如果和 String 相等，则为 true ；否则为 false 。

参见：

toLowerCase, toUpperCase

compareTo

 public int compareTo(String anotherString)

按词典顺序比较两个字符串。 比较的基础是字符串中每个字符的 Unicode 值。

参数：

anotherString - 要比较的 String 。

返回:

若参数字符串等于该字符串，则返回 0 ；若该字符串按词典顺序小于参数字符串则返回值小于 0 ；若该字符串按词典顺序大于参数字符串则返回值大于 0 。

regionMatches

 public boolean regionMatches(int toffset,
                              String other,
                              int ooffset,
                       int len)

测试两个字符串区域是否相等。

如果 toffset 或 ooffset 是负的，或如果 toffset+length 大于该字符串的长度， 或 ooffset+length 大于参数字符串的长度，那么该方法返回 false 。

参数：

toffset - 该字符串中子区域的开始偏移量。

other - 字符串参数。

ooffset - 参数字符串中子区域的开始偏移量。

len - 要比较的字符数。

返回:

若该字符串的指定子区域精确匹配参数字符串中的指定子区域则返回 true ，否则返回 false 。

regionMatches

 public boolean regionMatches(boolean ignoreCase,
                              int toffset,
                              String other,
                              int ooffset,
                       int len)

测试两个字符串区域是否相等。

如果 toffset 或 ooffset 是负的，或如果 toffset+length 大于该字符串的长度， 或 ooffset+length 大于参数字符串的长度，那么该方法返回 false 。

参数：

ignoreCase - 如果为 true ，则比较时忽略大小写。

toffset - 该字符串中子区域的开始偏移量。

other - 字符串参数。

ooffset - 参数字符串中子区域的开始偏移量。

len - 要比较的字符数。

返回:

若该字符串的指定子区域匹配参数字符串中的指定子区域则返回 true ，否则返回 false 。 匹配是否精确或是否大小写敏感依赖于 ignoreCase 参数。