String API常用方法介绍

Java 中的 String 类包含了 50 多个方法。令人惊讶的是绝大多数都很有用，可以设想使用的频率非常高。下面的 API（Java 应用程序编程接口）注释汇总了一部分最常用的方法。

在这里，一般不列出某个类的所有方法，而是选择一些最常用的方法，并以简洁的方式给予描述。这里还列出了所给类的版本号。如果某个方法是在这个版本之后添加的，就会给出一个单独的版本号。

在熟悉这些方法之前，我们先对码点和代码单元进行简单介绍：

• 码点：就是某个任意字符在 Unicode 编码表中对应的代码值。
• 代码单元：是在计算机中用来表示码点的，大部分码点只需要一个代码单元表示，但是有一些是需要两个代码单元表示的。

1）char charAt (int index)

返回给定位置的代码单元。除非对底层的代码单元感兴趣，否则不需要调用这个方法。

2）int codePointAt(int index) 5.0

返回从给定位置开始的码点。

3）int offsetByCodePoints(int startIndex,int cpCount) 5.0

返回从 startIndex 代码点开始，位移 cpCount 后的码点索引。

4）int compareTo(String other)

按照字典顺序，如果字符串位于 other 之前，返回一个负数；如果字符串位于 other 之后，返回一个正数；如果两个字符串相等，返回 0。

5）IntStream codePoints() 8

将这个字符串的码点作为一个流返回。调用 toArray 将它们放在一个数组中。

6） new String(int[] codePoints, int offset, int count) 5.0

用数组中从 offset 开始的 count 个码点构造一个字符串。

7）boolean equals(Object other)

如果字符串与 other 相等，返回 true。

8）boolean equalsIgnoreCase(String other)

如果字符串与 other 相等（忽略大小写）返回 true。

9）boolean startsWith(String prefix)

10）boolean endsWith(String suffix)

如果字符串以 suffix 开头或结尾，则返回 true。

11）int indexOf(String str)

12）int indexOf(String str, int fromIndex)

13）int indexOf(int cp)

14）int indexOf(int cp, int fromIndex)

返回与字符串 str 或代码点 cp 匹配的第一个子串的开始位置。这个位置从索引 0 或 fromIndex 开始计算。如果在原始串中不存在 str，返回 -1。

15）int lastIndexOf(String str)

16）int lastIndexOf(String str, int fromIndex)

17）int lastIndexOf(int cp)

18）int lastIndexOf(int cp, int fromIndex)

返回与字符串 str 或代码点 cp 匹配的最后一个子串的开始位置。这个位置从原始串尾端或 fromIndex 开始计算。

19）int length()

返回字符串的长度。

20）int codePointCount(int startIndex, int endIndex) 5.0

返回 startIndex 和 endIndex-1 之间的代码点数量。没有配成对的代用字符将计入代码点。

21）String replace(CharSequence oldString, CharSequence newString)

返回一个新字符串。这个字符串用 newString 代替原始字符串中所有的 oldString。可以用 String 或 StringBuilder 对象作为 CharSequence 参数。

22）String ​substring(int beginIndex)

23）String substring(int beginIndex, int endIndex)

返回一个新字符串。这个字符串包含原始字符串中从 beginlndex 到串尾或 endlndex-1 的所有代码单元。

24）String toLowerCase()

25）String toUpperCase()

返回一个新字符串。这个字符串将原始字符串中的大写字母改为小写，或者将原始字符串中的所有小写字母改成了大写字母。

26）String trim()

返回一个新字符串。这个字符串将删除了原始字符串头部和尾部的空格。

27）String join(CharSequence delimiter, CharSequence... elements) 8

返回一个新字符串，用给定的定界符连接所有元素。

在 API 注释中，有一些 CharSequence 类型的参数。这是一种接口类型，所有字符串都属于这个接口。教程后面将介绍更多有关接口类型的内容。现在只需要知道只要看到一个CharSequence 形参，完全可以传入 String 类型的实参。