java 核心技术-12版 卷Ⅰ- 3.6.7 String Api

3.6.7 String API

Java中的String 类包含近100个方法。下面的API 注释汇总了最常用的一些方法。

本书中给出的API 注释可以帮助你理解Java应用程序编程接口（API）。每一个API注释首先给出类名，如java.lang.String。（java.lang包名的重要性将在第4章给出解释）类名之后是一个或多个方法的名字、解释和参数描述。

API 注释不会列出一个特定类的所有方法，而是会以简洁的方式给出最常用的一些方法，完整的方法列表请参见联机文档（请参见3.8.6节）。

类名后面的编号是引入这个类的JDK版本号。如果某个方法是之后添加的，那么这个方法后面还会给出一个单独的版本号。

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

int codePointAt(int index) 5 返回从给定位置开始的码点。

int offsetByCodePoints(int startIndex,int cpCount) 5 返回从startIndex 码点开始，cpCount 个码点后的码点索引。

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

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

new String(int[] codePoints,int offset, int count) 5 用数组中从 offset 开始的 count 个码点构造一个字符串。

boolean isEmpty() 是否为空字符串 // “”是空白，即长度为0

boolean isBlank() 11 是否为空白字符串 // “” “ “ 等都是空白

boolean equals(Object other) 如果字符串与 other 相等，返回true。

boolean equalsIgnoreCase(String other) 如果字符串与other 相等(忽略大小写) 返回true。

boolean startsWith(String prefix) 如果字符串以 prefix 开头，返回true。例如 “help”.startsWith(“he”) 返回true

boolean endsWith(String suffix); 如果字符串以 suffix 结尾，返回true 。如 “help”.startsWith(“lp”) 返回true

int indexOf(String str) ; 返回str 在指定字符串中第一次出现的位置，如果没有，返回-1. 如 “help”.indexOf(“el”)返回1—— h的位置为0，e的位置为1.

int indexOf(String str,int fromIndex) ; 从 fromIndex位置开始（含），返回str 在指定字符串中第一次出现的位置，如果没有，返回-1. “helphelp”.indexOf(“el”,2) 返回5，因为从2开始的话，1不满足要求，只能匹配后面的 el

int indexOf(int cp) 返回与cp相等的码点第一个下标位置。“help”.indexOf(101)返回1，因为 101代表'e'，e所在为1

int indexOf(int cp,int fromIndex) 从 fromIndex位置开始（含）,返回与cp相等的码点第一个下标位置。“help”.indexOf(101,2)返回1，因为 101代表'e'，从下标2开始，首次发现 'e' 是在下标5的位置

int lastIndexOf(String str) ; 返回str 在指定字符串中最后一次出现的位置，如果没有，返回-1. 如 “helphelp”.indexOf(“el”)返回5—— “el”最后出现位置是5

int lastIndexOf(String str,int fromIndex) 从 fromIndex 开始，str 在字符串中最后一次出现的位置，如果没有，返回-1. 如 "helphelphelp".lastIndexOf(“el”,9)返回9。"helphelphelp".lastIndexOf(“el”,8) 返回5，因为从8开始计算时，最后的出现是在5的位置

int lastIndexOf(int cp) 返回cp 码点最后出现在字符串中的位置，没有返回-1

int lastIndexOf(int cp,int fromIndex)从 fromIndex 开始（含），返回cp 码点最后出现在字符串中的位置，没有返回-1

int length() .返回字符串的长度，注意，有些字符可能占2个位置，这时候计算长度时也算2.比如 System.out.println("".length()); 结果为2

int codePointCount(int startIndex,int endIndex) 5， 返回 startIndex（含） 到 endIndex（不含） 之间的码点个数

System.out.println("".codePointCount(0,2)); // 1

String replace(CharSequence oldString, CharSequence newString) 返回一个新字符串，此字符串是由newString 替换了字符串中的oldString 之后的字符串。如 “helphello”.replace(“el”,”ob”) 结果为 “hobphoblo”

String substring(int beginIndex) 返回从beginIndex 开始的子串。比如 “help”.substring(1),结果为”elp”

String substring(int beginIndex,int endIndex) 返回从beginIndex到endIndex(不含)结束的子串。如”hello”.substring(1,3)结果为“el”

String toLowerCase。返回全小写的字符串。比如 “Hello”.toLowerCase 返回 “hello”

String toUpperCase 返回全大写的字符串。比如 “Hello” 返回 “HELLO”

String strip()11 返回字符串去除两头空白字符后的字符串，注意，不会去除中间的空格，比如 “ Hello world ”返回”Hello world”(只去两头，不去中间的空白)—— 11之前时使用trim 方法，只能去除半角空格。strip 则可以去除全角空格

String stripLeading() 11,返回去除左边空白字符后的字符串。 “ Hello world ” 返回“Hello world ”

String stripTrailing() 11,返回去除右边空白字符后的字符串。 “ Hello world ” 返回“ Hello world”

String join(CharSequence delimiter, Charsequence ... elements)8 ,返回以 delimeter 为分隔符，连接所有 elements 的新字符串。如 String.join(":","hello","world","java") 结果为 hello:world:java

String repeat (int count) 11 返回一个字符串，将当前字符串重复 count 次，比如： “help”.repeat(2) 结果为”helphelp”