©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.lang.String
public final class String
String
类代表字符串。Java 程序中的所有字符串字面值(如 "abc"
)都作为此类的实例实现。
字符串是常量;它们的值在创建之后不能更改。字符串缓冲区支持可变的字符串。因为 String 对象是不可变的,所以可以共享。例如:
String str = "abc";
等效于:
char data[] = {'a', 'b', 'c'}; String str = new String(data);
下面给出了一些如何使用字符串的更多示例:
System.out.println("abc"); String cde = "cde"; System.out.println("abc" + cde); String c = "abc".substring(2,3); String d = cde.substring(1, 2);
String
类包括的方法可用于检查序列的单个字符、比较字符串、搜索字符串、提取子字符串、创建字符串副本并将所有字符全部转换为大写或小写。大小写映射基于 Character
类指定的 Unicode 标准版。
Java 语言提供对字符串串联符号("+")以及将其他对象转换为字符串的特殊支持。字符串串联是通过 StringBuilder
(或 StringBuffer
)类及其 append
方法实现的。字符串转换是通过 toString
方法实现的,该方法由 Object
类定义,并可被 Java 中的所有类继承。有关字符串串联和转换的更多信息,请参阅 Gosling、Joy 和 Steele 合著的 The Java Language Specification。
除非另行说明,否则将 null 参数传递给此类中的构造方法或方法将抛出 NullPointerException
。
String
表示一个 UTF-16 格式的字符串,其中的增补字符 由代理项对 表示(有关详细信息,请参阅 Character
类中的 Unicode 字符表示形式)。索引值是指 char
代码单元,因此增补字符在 String
中占用两个位置。
String
类提供处理 Unicode 代码点(即字符)和 Unicode 代码单元(即 char
值)的方法。
Object.toString()
,
StringBuffer
,
StringBuilder
,
Charset
,
序列化表格字段摘要 | |
---|---|
static Comparator<String> |
CASE_INSENSITIVE_ORDER
一个对 String 对象进行排序的 Comparator,作用与 compareToIgnoreCase 相同。 |
构造方法摘要 | |
---|---|
String()
初始化一个新创建的 String 对象,使其表示一个空字符序列。 |
|
String(byte[] bytes)
通过使用平台的默认字符集解码指定的 byte 数组,构造一个新的 String 。 |
|
String(byte[] bytes,
Charset charset)
通过使用指定的 charset 解码指定的 byte 数组,构造一个新的 String 。 |
|
String(byte[] ascii,
int hibyte)
已过时。 该方法无法将字节正确地转换为字符。从 JDK 1.1 开始,完成该转换的首选方法是使用带有 Charset 、字符集名称,或使用平台默认字符集的 String 构造方法。
|
|
String(byte[] bytes,
int offset,
int length)
通过使用平台的默认字符集解码指定的 byte 子数组,构造一个新的 String 。 |
|
String(byte[] bytes,
int offset,
int length,
Charset charset)
通过使用指定的 charset 解码指定的 byte 子数组,构造一个新的 String 。 |
|
String(byte[] ascii,
int hibyte,
int offset,
int count)
已过时。 该方法无法将字节正确地转换为字符。从 JDK 1.1 开始,完成该转换的首选方法是使用带有 Charset 、字符集名称,或使用平台默认字符集的 String 构造方法。
|
|
String(byte[] bytes,
int offset,
int length,
String charsetName)
通过使用指定的字符集解码指定的 byte 子数组,构造一个新的 String 。 |
|
String(byte[] bytes,
String charsetName)
通过使用指定的 charset 解码指定的 byte 数组,构造一个新的 String 。 |
|
String(char[] value)
分配一个新的 String ,使其表示字符数组参数中当前包含的字符序列。 |
|
String(char[] value,
int offset,
int count)
分配一个新的 String ,它包含取自字符数组参数一个子数组的字符。 |
|
String(int[] codePoints,
int offset,
int count)
分配一个新的 String ,它包含 Unicode 代码点数组参数一个子数组的字符。 |
|
String(String original)
初始化一个新创建的 String 对象,使其表示一个与参数相同的字符序列;换句话说,新创建的字符串是该参数字符串的副本。 |
|
String(StringBuffer buffer)
分配一个新的字符串,它包含字符串缓冲区参数中当前包含的字符序列。 |
|
String(StringBuilder builder)
分配一个新的字符串,它包含字符串生成器参数中当前包含的字符序列。 |
方法摘要 | |
---|---|
char |
charAt(int index)
返回指定索引处的 char 值。 |
int |
codePointAt(int index)
返回指定索引处的字符(Unicode 代码点)。 |
int |
codePointBefore(int index)
返回指定索引之前的字符(Unicode 代码点)。 |
int |
codePointCount(int beginIndex,
int endIndex)
返回此 String 的指定文本范围中的 Unicode 代码点数。 |
int |
compareTo(String anotherString)
按字典顺序比较两个字符串。 |
int |
compareToIgnoreCase(String str)
按字典顺序比较两个字符串,不考虑大小写。 |
String |
concat(String str)
将指定字符串连接到此字符串的结尾。 |
boolean |
contains(CharSequence s)
当且仅当此字符串包含指定的 char 值序列时,返回 true。 |
boolean |
contentEquals(CharSequence cs)
将此字符串与指定的 CharSequence 比较。 |
boolean |
contentEquals(StringBuffer sb)
将此字符串与指定的 StringBuffer 比较。 |
static String |
copyValueOf(char[] data)
返回指定数组中表示该字符序列的 String。 |
static String |
copyValueOf(char[] data,
int offset,
int count)
返回指定数组中表示该字符序列的 String。 |
boolean |
endsWith(String suffix)
测试此字符串是否以指定的后缀结束。 |
boolean |
equals(Object anObject)
将此字符串与指定的对象比较。 |
boolean |
equalsIgnoreCase(String anotherString)
将此 String 与另一个 String 比较,不考虑大小写。 |
static String |
format(Locale l,
String format,
Object... args)
使用指定的语言环境、格式字符串和参数返回一个格式化字符串。 |
static String |
format(String format,
Object... args)
使用指定的格式字符串和参数返回一个格式化字符串。 |
byte[] |
getBytes()
使用平台的默认字符集将此 String 编码为 byte 序列,并将结果存储到一个新的 byte 数组中。 |
byte[] |
getBytes(Charset charset)
使用给定的 charset 将此 String 编码到 byte 序列,并将结果存储到新的 byte 数组。 |
void |
getBytes(int srcBegin,
int srcEnd,
byte[] dst,
int dstBegin)
已过时。 该方法无法将字符正确转换为字节。从 JDK 1.1 起,完成该转换的首选方法是通过 getBytes() 方法,该方法使用平台的默认字符集。
|
byte[] |
getBytes(String charsetName)
使用指定的字符集将此 String 编码为 byte 序列,并将结果存储到一个新的 byte 数组中。 |
void |
getChars(int srcBegin,
int srcEnd,
char[] dst,
int dstBegin)
将字符从此字符串复制到目标字符数组。 |
int |
hashCode()
返回此字符串的哈希码。 |
int |
indexOf(int ch)
返回指定字符在此字符串中第一次出现处的索引。 |
int |
indexOf(int ch,
int fromIndex)
返回在此字符串中第一次出现指定字符处的索引,从指定的索引开始搜索。 |
int |
indexOf(String str)
返回指定子字符串在此字符串中第一次出现处的索引。 |
int |
indexOf(String str,
int fromIndex)
返回指定子字符串在此字符串中第一次出现处的索引,从指定的索引开始。 |
String |
intern()
返回字符串对象的规范化表示形式。 |
boolean |
isEmpty()
当且仅当 length() 为 0 时返回 true。 |
int |
lastIndexOf(int ch)
返回指定字符在此字符串中最后一次出现处的索引。 |
int |
lastIndexOf(int ch,
int fromIndex)
返回指定字符在此字符串中最后一次出现处的索引,从指定的索引处开始进行反向搜索。 |
int |
lastIndexOf(String str)
返回指定子字符串在此字符串中最右边出现处的索引。 |
int |
lastIndexOf(String str,
int fromIndex)
返回指定子字符串在此字符串中最后一次出现处的索引,从指定的索引开始反向搜索。 |
int |
length()
返回此字符串的长度。 |
boolean |
matches(String regex)
告知此字符串是否匹配给定的正则表达式。 |
int |
offsetByCodePoints(int index,
int codePointOffset)
返回此 String 中从给定的 index 处偏移 codePointOffset 个代码点的索引。 |
boolean |
regionMatches(boolean ignoreCase,
int toffset,
String other,
int ooffset,
int len)
测试两个字符串区域是否相等。 |
boolean |
regionMatches(int toffset,
String other,
int ooffset,
int len)
测试两个字符串区域是否相等。 |
String |
replace(char oldChar,
char newChar)
返回一个新的字符串,它是通过用 newChar 替换此字符串中出现的所有 oldChar 得到的。 |
String |
replace(CharSequence target,
CharSequence replacement)
使用指定的字面值替换序列替换此字符串所有匹配字面值目标序列的子字符串。 |
String |
replaceAll(String regex,
String replacement)
使用给定的 replacement 替换此字符串所有匹配给定的正则表达式的子字符串。 |
String |
replaceFirst(String regex,
String replacement)
使用给定的 replacement 替换此字符串匹配给定的正则表达式的第一个子字符串。 |
String[] |
split(String regex)
根据给定正则表达式的匹配拆分此字符串。 |
String[] |
split(String regex,
int limit)
根据匹配给定的正则表达式来拆分此字符串。 |
boolean |
startsWith(String prefix)
测试此字符串是否以指定的前缀开始。 |
boolean |
startsWith(String prefix,
int toffset)
测试此字符串从指定索引开始的子字符串是否以指定前缀开始。 |
CharSequence |
subSequence(int beginIndex,
int endIndex)
返回一个新的字符序列,它是此序列的一个子序列。 |
String |
substring(int beginIndex)
返回一个新的字符串,它是此字符串的一个子字符串。 |
String |
substring(int beginIndex,
int endIndex)
返回一个新字符串,它是此字符串的一个子字符串。 |
char[] |
toCharArray()
将此字符串转换为一个新的字符数组。 |
String |
toLowerCase()
使用默认语言环境的规则将此 String 中的所有字符都转换为小写。 |
String |
toLowerCase(Locale locale)
使用给定 Locale 的规则将此 String 中的所有字符都转换为小写。 |
String |
toString()
返回此对象本身(它已经是一个字符串!)。 |
String |
toUpperCase()
使用默认语言环境的规则将此 String 中的所有字符都转换为大写。 |
String |
toUpperCase(Locale locale)
使用给定 Locale 的规则将此 String 中的所有字符都转换为大写。 |
String |
trim()
返回字符串的副本,忽略前导空白和尾部空白。 |
static String |
valueOf(boolean b)
返回 boolean 参数的字符串表示形式。 |
static String |
valueOf(char c)
返回 char 参数的字符串表示形式。 |
static String |
valueOf(char[] data)
返回 char 数组参数的字符串表示形式。 |
static String |
valueOf(char[] data,
int offset,
int count)
返回 char 数组参数的特定子数组的字符串表示形式。 |
static String |
valueOf(double d)
返回 double 参数的字符串表示形式。 |
static String |
valueOf(float f)
返回 float 参数的字符串表示形式。 |
static String |
valueOf(int i)
返回 int 参数的字符串表示形式。 |
static String |
valueOf(long l)
返回 long 参数的字符串表示形式。 |
static String |
valueOf(Object obj)
返回 Object 参数的字符串表示形式。 |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final Comparator<String> CASE_INSENSITIVE_ORDER
String
对象进行排序的 Comparator,作用与 compareToIgnoreCase
相同。此比较器是可序列化的。
注意,Comparator 不 考虑语言环境,因此可能导致在某些语言环境中的排序效果不理想。java.text 包提供 Collator 完成与语言环境有关的排序。
Collator.compare(String, String)
构造方法详细信息 |
---|
public String()
String
对象,使其表示一个空字符序列。注意,由于 String 是不可变的,所以无需使用此构造方法。
public String(String original)
String
对象,使其表示一个与参数相同的字符序列;换句话说,新创建的字符串是该参数字符串的副本。由于 String 是不可变的,所以无需使用此构造方法,除非需要 original
的显式副本。
original
- 一个 String
。public String(char[] value)
String
,使其表示字符数组参数中当前包含的字符序列。该字符数组的内容已被复制;后续对字符数组的修改不会影响新创建的字符串。
value
- 字符串的初始值public String(char[] value, int offset, int count)
String
,它包含取自字符数组参数一个子数组的字符。offset
参数是子数组第一个字符的索引,count
参数指定子数组的长度。该子数组的内容已被复制;后续对字符数组的修改不会影响新创建的字符串。
value
- 作为字符源的数组。offset
- 初始偏移量。count
- 长度。
IndexOutOfBoundsException
- 如果 offset
和 count
参数索引字符超出 value
数组的范围。public String(int[] codePoints, int offset, int count)
String
,它包含 Unicode 代码点数组参数一个子数组的字符。offset
参数是该子数组第一个代码点的索引,count
参数指定子数组的长度。将该子数组的内容转换为 char
;后续对 int
数组的修改不会影响新创建的字符串。
codePoints
- 作为 Unicode 代码点的源的数组。offset
- 初始偏移量。count
- 长度。
IllegalArgumentException
- 如果在 codePoints
中发现任何无效的 Unicode 代码点
IndexOutOfBoundsException
- 如果 offset
和 count
参数索引字符超出 codePoints
数组的范围。@Deprecated public String(byte[] ascii, int hibyte, int offset, int count)
Charset
、字符集名称,或使用平台默认字符集的 String
构造方法。
String
,它是根据一个 8 位整数值数组的子数组构造的。
offset
参数是该子数组的第一个 byte 的索引,count
参数指定子数组的长度。
子数组中的每个 byte
都按照上述方法转换为 char
。
ascii
- 要转换为字符的 byte。hibyte
- 每个 16 位 Unicode 代码单元的前 8 位。offset
- 初始偏移量。count
- 长度。
IndexOutOfBoundsException
- 如果 offset
或 count
参数无效。String(byte[], int)
,
String(byte[], int, int, java.lang.String)
,
String(byte[], int, int, java.nio.charset.Charset)
,
String(byte[], int, int)
,
String(byte[], java.lang.String)
,
String(byte[], java.nio.charset.Charset)
,
String(byte[])
@Deprecated public String(byte[] ascii, int hibyte)
Charset
、字符集名称,或使用平台默认字符集的 String
构造方法。
String
,它包含根据一个 8 位整数值数组构造的字符。所得字符串中的每个字符 c 都是根据 byte 数组中的相应组件 b 构造的,如下所示:
c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
ascii
- 要转换为字符的 byte。hibyte
- 每个 16 位 Unicode 代码单元的前 8 位。String(byte[], int, int, java.lang.String)
,
String(byte[], int, int, java.nio.charset.Charset)
,
String(byte[], int, int)
,
String(byte[], java.lang.String)
,
String(byte[], java.nio.charset.Charset)
,
String(byte[])
public String(byte[] bytes, int offset, int length, String charsetName) throws UnsupportedEncodingException
String
。新 String
的长度是一个字符集函数,因此可能不等于子数组的长度。
当给定 byte 在给定字符集中无效的情况下,此构造方法的行为没有指定。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 byteoffset
- 要解码的第一个 byte 的索引length
- 要解码的 byte 数charsetName
- 受支持 charset 的名称
UnsupportedEncodingException
- 如果指定的字符集不受支持
IndexOutOfBoundsException
- 如果 offset
和 length
参数索引字符超出 bytes
数组的范围public String(byte[] bytes, int offset, int length, Charset charset)
String
。新 String
的长度是字符集的函数,因此可能不等于子数组的长度。
此方法总是使用此字符集的默认替代字符串替代错误输入 (malformed-input) 和不可映射字符 (unmappable-character) 序列。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 byteoffset
- 要解码的第一个 byte 的索引length
- 要解码的 byte 数charset
- 用来解码 bytes
的 charset
IndexOutOfBoundsException
- 如果 offset
和 length
参数索引字符超出 bytes
数组的边界public String(byte[] bytes, String charsetName) throws UnsupportedEncodingException
String
。新 String
的长度是字符集的函数,因此可能不等于 byte 数组的长度。
当给定 byte 在给定字符集中无效的情况下,此构造方法的行为没有指定。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 bytecharsetName
- 受支持的 charset 的名称
UnsupportedEncodingException
- 如果指定字符集不受支持public String(byte[] bytes, Charset charset)
String
。新 String
的长度是字符集的函数,因此可能不等于 byte 数组的长度。
此方法总是使用此字符集的默认替代字符串替代错误输入和不可映射字符序列。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 bytecharset
- 要用来解码 bytes
的 charsetpublic String(byte[] bytes, int offset, int length)
String
。新 String
的长度是字符集的函数,因此可能不等于该子数组的长度。
当给定 byte 在给定字符集中无效的情况下,此构造方法的行为没有指定。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 byteoffset
- 要解码的第一个 byte 的索引length
- 要解码的 byte 数
IndexOutOfBoundsException
- 如果 offset
和 length
参数索引字符超出 bytes
数组的范围public String(byte[] bytes)
String
。新 String
的长度是字符集的函数,因此可能不等于 byte 数组的长度。
当给定 byte 在给定字符集中无效的情况下,此构造方法的行为没有指定。如果需要对解码过程进行更多控制,则应该使用 CharsetDecoder
类。
bytes
- 要解码为字符的 bytepublic String(StringBuffer buffer)
buffer
- 一个 StringBuffer
public String(StringBuilder builder)
提供此构造方法是为了简化到 StringBuilder
的迁移。通过 toString
方法从字符串生成器中获取字符串可能运行的更快,因此通常作为首选。
builder
- 一个 StringBuilder
方法详细信息 |
---|
public int length()
CharSequence
中的 length
public boolean isEmpty()
length()
为 0 时返回 true。
length()
为 0,则返回 true;否则返回 false。public char charAt(int index)
char
值。索引范围为从 0
到 length() - 1
。序列的第一个 char
值位于索引 0
处,第二个位于索引 1
处,依此类推,这类似于数组索引。
如果索引指定的 char
值是代理项,则返回代理项值。
CharSequence
中的 charAt
index
- char
值的索引。
char
值。第一个 char
值位于索引 0
处。
IndexOutOfBoundsException
- 如果 index
参数为负或小于此字符串的长度。public int codePointAt(int index)
char
值(Unicode 代码单元),其范围从 0
到 length()
- 1
。
如果给定索引指定的 char
值属于高代理项范围,则后续索引小于此 String
的长度;如果后续索引处的 char
值属于低代理项范围,则返回该代理项对相应的增补代码点。否则,返回给定索引处的 char
值。
index
- char
值的索引
index
处字符的代码点值
IndexOutOfBoundsException
- 如果 index
参数为负或小于此字符串的长度。public int codePointBefore(int index)
char
值(Unicode 代码单元),其范围从 1
到 length
。
如果 (index - 1)
处的 char
值属于低代理项范围,则 (index - 2)
为非负;如果 (index - 2)
处的 char
值属于高低理项范围,则返回该代理项对的增补代码点值。如果 index - 1
处的 char
值是未配对的低(高)代理项,则返回代理项值。
index
- 应返回的代码点之后的索引
IndexOutOfBoundsException
- 如果 index
参数小于 1 或大于此字符串的长度。public int codePointCount(int beginIndex, int endIndex)
String
的指定文本范围中的 Unicode 代码点数。文本范围始于指定的 beginIndex
,一直到索引 endIndex - 1
处的 char
。因此,该文本范围的长度(用 char
表示)是 endIndex-beginIndex
。该文本范围内每个未配对的代理项计为一个代码点。
beginIndex
- 文本范围的第一个 char
的索引。endIndex
- 文本范围的最后一个 char
之后的索引。
IndexOutOfBoundsException
- 如果 beginIndex
为负,或 endIndex
大于此 String
的长度,或 beginIndex
大于 endIndex
。public int offsetByCodePoints(int index, int codePointOffset)
String
中从给定的 index
处偏移 codePointOffset
个代码点的索引。文本范围内由 index
和 codePointOffset
给定的未配对代理项各计为一个代码点。
index
- 要偏移的索引codePointOffset
- 代码点中的偏移量
String
的索引
IndexOutOfBoundsException
- 如果 index
为负或大于此 String
的长度;或者 codePointOffset
为正,且以 index
开头子字符串的代码点比 codePointOffset
少;如果 codePointOffset
为负,且 index
前面子字符串的代码点比 codePointOffset
的绝对值少。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
- 目标数组中的起始偏移量。
IndexOutOfBoundsException
- 如果下列任何一项为 true:
srcBegin
为负。
srcBegin
大于 srcEnd
srcEnd
大于此字符串的长度
dstBegin
为负
dstBegin+(srcEnd-srcBegin)
大于 dst.length
@Deprecated public void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)
getBytes()
方法,该方法使用平台的默认字符集。
要复制的第一个字符位于索引 srcBegin
处;要复制的最后一个字符位于索引 srcEnd-1
处。要复制的字符总数为 srcEnd-srcBegin
。将转换为 byte 的字符复制到 dst
的子数组中,从索引 dstBegin
处开始,并结束于索引:
dstbegin + (srcEnd-srcBegin) - 1
srcBegin
- 字符串中要复制的第一个字符的索引srcEnd
- 字符串中要复制的最后一个字符之后的索引dst
- 目标数组dstBegin
- 目标数组中的起始偏移量
IndexOutOfBoundsException
- 如果下列任何一项为 true:
srcBegin
为负
srcBegin
大于 srcEnd
srcEnd
大于此 String 的长度
dstBegin
为负
dstBegin+(srcEnd-srcBegin)
大于 dst.length
public byte[] getBytes(String charsetName) throws UnsupportedEncodingException
String
编码为 byte 序列,并将结果存储到一个新的 byte 数组中。
当此字符串不能使用给定的字符集编码时,此方法的行为没有指定。如果需要对编码过程进行更多控制,则应该使用 CharsetEncoder
类。
charsetName
- 受支持的 charset 名称
UnsupportedEncodingException
- 如果指定的字符集不受支持public byte[] getBytes(Charset charset)
String
编码到 byte 序列,并将结果存储到新的 byte 数组。
此方法总是使用此字符集的默认替代 byte 数组替代错误输入和不可映射字符序列。如果需要对编码过程进行更多控制,则应该使用 CharsetEncoder
类。
charset
- 用于编码 String
的 Charset
public byte[] getBytes()
String
编码为 byte 序列,并将结果存储到一个新的 byte 数组中。
当此字符串不能使用默认的字符集编码时,此方法的行为没有指定。如果需要对编码过程进行更多控制,则应该使用 CharsetEncoder
类。
public boolean equals(Object anObject)
null
,并且是与此对象表示相同字符序列的 String
对象时,结果才为 true
。
Object
中的 equals
anObject
- 与此 String
进行比较的对象。
String
与此 String
相等,则返回 true
;否则返回 false
。compareTo(String)
,
equalsIgnoreCase(String)
public boolean contentEquals(StringBuffer sb)
StringBuffer
比较。当且仅当此 String
与指定 StringBuffer
表示相同的字符序列时,结果才为 true
。
sb
- 要与此 String
比较的 StringBuffer
。
String
与指定 StringBuffer
表示相同的字符序列,则返回 true
;否则返回 false
。public boolean contentEquals(CharSequence cs)
CharSequence
比较。当且仅当此 String
与指定序列表示相同的 char 值序列时,结果才为 true
。
cs
- 要与此 String
比较的序列
String
与指定序列表示相同的 char 值序列,则返回 true
;否则返回 false
。public boolean equalsIgnoreCase(String anotherString)
String
与另一个 String
比较,不考虑大小写。如果两个字符串的长度相同,并且其中的相应字符都相等(忽略大小写),则认为这两个字符串是相等的。
在忽略大小写的情况下,如果下列至少一项为 true,则认为 c1
和 c2
这两个字符相同。
==
运算符进行比较)。
Character.toUpperCase(char)
生成相同的结果。
Character.toLowerCase(char)
生成相同的结果。
anotherString
- 与此 String
进行比较的 String
。
null
,且这两个 String
相等(忽略大小写),则返回 true
;否则返回 false
。equals(Object)
public int compareTo(String anotherString)
String
对象表示的字符序列与参数字符串所表示的字符序列进行比较。如果按字典顺序此 String
对象位于参数字符串之前,则比较结果为一个负整数。如果按字典顺序此 String
对象位于参数字符串之后,则比较结果为一个正整数。如果这两个字符串相等,则结果为 0;compareTo
只在方法 equals(Object)
返回 true
时才返回 0
。
这是字典排序的定义。如果这两个字符串不同,那么它们要么在某个索引处的字符不同(该索引对二者均为有效索引),要么长度不同,或者同时具备这两种情况。如果它们在一个或多个索引位置上的字符不同,假设 k 是这类索引的最小值;则在位置 k 上具有较小值的那个字符串(使用 < 运算符确定),其字典顺序在其他字符串之前。在这种情况下,compareTo
返回这两个字符串在位置 k
处两个char 值的差,即值:
如果没有字符不同的索引位置,则较短字符串的字典顺序在较长字符串之前。在这种情况下,this.charAt(k)-anotherString.charAt(k)
compareTo
返回这两个字符串长度的差,即值:
this.length()-anotherString.length()
Comparable<String>
中的 compareTo
anotherString
- 要比较的 String
。
0
;如果此字符串按字典顺序小于字符串参数,则返回一个小于 0
的值;如果此字符串按字典顺序大于字符串参数,则返回一个大于 0
的值。public int compareToIgnoreCase(String str)
compareTo
所得符号相同,规范化字符串的大小写差异已通过对每个字符调用 Character.toLowerCase(Character.toUpperCase(character))
消除。
注意,此方法不 考虑语言环境,因此可能导致在某些语言环境中的排序效果不理想。java.text 包提供 Collators 完成与语言环境有关的排序。
str
- 要比较的 String
。
Collator.compare(String, String)
public boolean regionMatches(int toffset, String other, int ooffset, int len)
将此 String 对象的一个子字符串与参数 other 的一个子字符串进行比较。如果这两个子字符串表示相同的字符序列,则结果为 true。要比较的此 String 对象的子字符串从索引 toffset 处开始,长度为 len。要比较的 other 的子字符串从索引 ooffset 处开始,长度为 len。当且仅当下列至少一项为 true 时,结果才为 false :
toffset
- 字符串中子区域的起始偏移量。other
- 字符串参数。ooffset
- 字符串参数中子区域的起始偏移量。len
- 要比较的字符数。
true
;否则返回 false
。public boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)
将此 String 对象的子字符串与参数 other 的子字符串进行比较。如果这两个子字符串表示相同的字符序列,则结果为 true,当且仅当 ignoreCase 为 true 时忽略大小写。要比较的此 String 对象的子字符串从索引 toffset 处开始,长度为 len。要比较的 other 的子字符串从索引 ooffset 处开始,长度为 len。当且仅当下列至少一项为 true 时,结果才为 false:
this.charAt(toffset+k) != other.charAt(ooffset+k)
以及:Character.toLowerCase(this.charAt(toffset+k)) != Character.toLowerCase(other.charAt(ooffset+k))
Character.toUpperCase(this.charAt(toffset+k)) != Character.toUpperCase(other.charAt(ooffset+k))
ignoreCase
- 如果为 true
,则比较字符时忽略大小写。toffset
- 此字符串中子区域的起始偏移量。other
- 字符串参数。toffset
- 字符串参数中子区域的起始偏移量。len
- 要比较的字符数。
true
;否则返回 false
。是否完全匹配或考虑大小写取决于 ignoreCase
参数。public boolean startsWith(String prefix, int toffset)
prefix
- 前缀。toffset
- 在此字符串中开始查找的位置。
toffset
处开始的子字符串前缀,则返回 true
;否则返回 false
。如果 toffset
为负或大于此 String
对象的长度,则结果为 false
;否则结果与以下表达式的结果相同:
this.substring(toffset).startsWith(prefix)
public boolean startsWith(String prefix)
prefix
- 前缀。
true
;否则返回 false
。还要注意,如果参数是空字符串,或者等于此 String
对象(用 equals(Object)
方法确定),则返回 true
。public boolean endsWith(String suffix)
suffix
- 后缀。
true
;否则返回 false
。注意,如果参数是空字符串,或者等于此 String
对象(用 equals(Object)
方法确定),则结果为 true
。public int hashCode()
String
对象的哈希码根据以下公式计算:
使用s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
int
算法,这里 s[i]
是字符串的第 i 个字符,n
是字符串的长度,^
表示求幂。(空字符串的哈希值为 0。)
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
public int indexOf(int ch)
String
对象表示的字符序列中出现值为 ch
的字符,则返回第一次出现该字符的索引(以 Unicode 代码单元表示)。对于 0 到 0xFFFF(包括 0 和 0xFFFF)范围内的 ch
的值,返回值是
为 true 的最小 k 值。对于其他this.charAt(k) == ch
ch
值,返回值是
为 true 最小 k 值。无论哪种情况,如果此字符串中没有这样的字符,则返回this.codePointAt(k) == ch
-1
。
ch
- 一个字符(Unicode 代码点)。
-1
。public int indexOf(int ch, int fromIndex)
在此 String
对象表示的字符序列中,如果带有值 ch
的字符的索引不小于 fromIndex
,则返回第一次出现该值的索引。对于 0 到 0xFFFF(包括 0 和 0xFFFF)范围内的 ch
值,返回值是
为 true 的最小 k 值。对于其他(this.charAt(k) == ch) && (k >= fromIndex)
ch
值,返回值是
为 true 的最小 k 值。无论哪种情况,如果此字符串中(this.codePointAt(k) == ch) && (k >= fromIndex)
fromIndex
或之后的位置没有这样的字符出现,则返回 -1
。
fromIndex
的值没有限制。如果它为负,则与它为 0 的效果同样:将搜索整个字符串。如果它大于此字符串的长度,则与它等于此字符串长度的效果相同:返回 -1
。
所有索引都在 char
值中指定(Unicode 代码单元)。
ch
- 一个字符(Unicode 代码点)。fromIndex
- 开始搜索的索引。
fromIndex
的字符的索引;如果未出现该字符,则返回 -1
。public int lastIndexOf(int ch)
ch
的值,返回的索引(Unicode 代码单元)是
为 true 最大 k 值。对于其他this.charAt(k) == ch
ch
值,返回值是
为 true 的最大 k 值。无论哪种情况,如果此字符串中没有这样的字符出现,则返回this.codePointAt(k) == ch
-1
。从最后一个字符开始反向搜索此 String
。
ch
- 一个字符(Unicode 代码点)。
-1
。public int lastIndexOf(int ch, int fromIndex)
ch
值,返回的索引是
为 true 的最大 k 值。对于(this.charAt(k) == ch) && (k <= fromIndex)
ch
的其他值,返回值是
为 true 的最大 k 值。无论哪种情况,如果此字符串中(this.codePointAt(k) == ch) && (k <= fromIndex)
fromIndex
或之前的位置没有这样的字符出现,则返回 -1
。
所有的索引都以 char
值指定(Unicode 代码单元)。
ch
- 一个字符(Unicode 代码点)。fromIndex
- 开始搜索的索引。fromIndex
的值没有限制。如果它大于等于此字符串的长度,则与它小于此字符串长度减 1 的效果相同:将搜索整个字符串。如果它为负,则与它为 -1 的效果相同:返回 -1。
fromIndex
)中最后一次出现该字符的索引;如果在该点之前未出现该字符,则返回 -1
。public int indexOf(String str)
为this.startsWith(str, k)
true
的最小 k 值。
str
- 任意字符串。
-1
。public int indexOf(String str, int fromIndex)
如果不存在这样的 k 值,则返回 -1。k >= Math.min(fromIndex, this.length()) && this.startsWith(str, k)
str
- 要搜索的子字符串。fromIndex
- 开始搜索的索引位置。
public int lastIndexOf(String str)
this.length()
处。返回的索引是
为 true 的最大 k 值。this.startsWith(str, k)
str
- 要搜索的子字符串。
-1
。public int lastIndexOf(String str, int fromIndex)
如果不存在这样的 k 值,则返回 -1。k <= Math.min(fromIndex,this.length()) && this.startsWith(str, k)
str
- 要搜索的子字符串。fromIndex
- 开始搜索的索引位置。
public String substring(int beginIndex)
示例:
"unhappy".substring(2) returns "happy" "Harbison".substring(3) returns "bison" "emptiness".substring(9) returns "" (an empty string)
beginIndex
- 起始索引(包括)。
IndexOutOfBoundsException
- 如果 beginIndex
为负或大于此 String
对象的长度。public String substring(int beginIndex, int endIndex)
beginIndex
处开始,直到索引 endIndex - 1
处的字符。因此,该子字符串的长度为 endIndex-beginIndex
。
示例:
"hamburger".substring(4, 8) returns "urge" "smiles".substring(1, 5) returns "mile"
beginIndex
- 起始索引(包括)。endIndex
- 结束索引(不包括)。
IndexOutOfBoundsException
- 如果 beginIndex
为负,或 endIndex
大于此 String
对象的长度,或 beginIndex
大于 endIndex
。public CharSequence subSequence(int beginIndex, int endIndex)
此方法这种形式的调用:
与以下调用的行为完全相同:str.subSequence(begin, end)
定义此方法使 String 类能够实现str.substring(begin, end)
CharSequence
接口。
CharSequence
中的 subSequence
beginIndex
- 起始索引(包括)。endIndex
- 结束索引(不包括)。
IndexOutOfBoundsException
- 如果 beginIndex 或 endIndex 为负,如果 endIndex 大于 length() 或 beginIndex 大于 startIndex
public String concat(String str)
如果参数字符串的长度为 0
,则返回此 String
对象。否则,创建一个新的 String
对象,用来表示由此 String
对象表示的字符序列和参数字符串表示的字符序列连接而成的字符序列。
示例:
"cares".concat("s") returns "caress" "to".concat("get").concat("her") returns "together"
str
- 连接到此 String
结尾的 String
。
public String replace(char oldChar, char newChar)
newChar
替换此字符串中出现的所有 oldChar
得到的。
如果 oldChar
在此 String
对象表示的字符序列中没有出现,则返回对此 String
对象的引用。否则,创建一个新的 String
对象,它所表示的字符序列除了所有的 oldChar
都被替换为 newChar
之外,与此 String
对象表示的字符序列相同。
示例:
"mesquite in your cellar".replace('e', 'o') returns "mosquito in your collar" "the war of baronets".replace('r', 'y') returns "the way of bayonets" "sparring with a purple porpoise".replace('p', 't') returns "starring with a turtle tortoise" "JonL".replace('q', 'x') returns "JonL" (no change)
oldChar
- 原字符。newChar
- 新字符。
oldChar
替代为 newChar
。public boolean matches(String regex)
调用此方法的 str.matches(regex) 形式与以下表达式产生的结果完全相同:
Pattern
.matches
(regex, str)
regex
- 用来匹配此字符串的正则表达式
PatternSyntaxException
- 如果正则表达式的语法无效Pattern
public boolean contains(CharSequence s)
s
- 要搜索的序列
s
,则返回 true,否则返回 false
NullPointerException
- 如果 s
为 null
public String replaceFirst(String regex, String replacement)
调用此方法的 str.replaceFirst(regex, repl) 形式与以下表达式产生的结果完全相同:
Pattern
.compile
(regex).matcher
(str).replaceFirst
(repl)
注意,在替代字符串中使用反斜杠 (\) 和美元符号 ($) 与将其视为字面值替代字符串所得的结果可能不同;请参阅 Matcher.replaceFirst(java.lang.String)
。如有需要,可使用 Matcher.quoteReplacement(java.lang.String)
取消这些字符的特殊含义。
regex
- 用来匹配此字符串的正则表达式replacement
- 用来替换第一个匹配项的字符串
PatternSyntaxException
- 如果正则表达式的语法无效Pattern
public String replaceAll(String regex, String replacement)
调用此方法的 str.replaceAll(regex, repl) 形式与以下表达式产生的结果完全相同:
Pattern
.compile
(regex).matcher
(str).replaceAll
(repl)
注意,在替代字符串中使用反斜杠 (\) 和美元符号 ($) 与将其视为字面值替代字符串所得的结果可能不同;请参阅 Matcher.replaceAll
。如有需要,可使用 Matcher.quoteReplacement(java.lang.String)
取消这些字符的特殊含义。
regex
- 用来匹配此字符串的正则表达式replacement
- 用来替换每个匹配项的字符串
PatternSyntaxException
- 如果正则表达式的语法无效Pattern
public String replace(CharSequence target, CharSequence replacement)
target
- 要被替换的 char 值序列replacement
- char 值的替换序列
NullPointerException
- 如果 target
或 replacement
为 null
。public String[] split(String regex, int limit)
此方法返回的数组包含此字符串的子字符串,每个子字符串都由另一个匹配给定表达式的子字符串终止,或者由此字符串末尾终止。数组中的子字符串按它们在此字符串中出现的顺序排列。如果表达式不匹配输入的任何部分,那么所得数组只具有一个元素,即此字符串。
limit 参数控制模式应用的次数,因此影响所得数组的长度。如果该限制 n 大于 0,则模式将被最多应用 n - 1 次,数组的长度将不会大于 n,而且数组的最后一项将包含所有超出最后匹配的定界符的输入。如果 n 为非正,那么模式将被应用尽可能多的次数,而且数组可以是任何长度。如果 n 为 0,那么模式将被应用尽可能多的次数,数组可以是任何长度,并且结尾空字符串将被丢弃。
例如,字符串 "boo:and:foo" 使用这些参数可生成以下结果:
Regex Limit 结果 : 2 { "boo", "and:foo" } : 5 { "boo", "and", "foo" } : -2 { "boo", "and", "foo" } o 5 { "b", "", ":and:f", "", "" } o -2 { "b", "", ":and:f", "", "" } o 0 { "b", "", ":and:f" }
调用此方法的 str.split(regex, n) 形式与以下表达式产生的结果完全相同:
Pattern
.compile
(regex).split
(str, n)
regex
- 定界正则表达式limit
- 结果阈值,如上所述
PatternSyntaxException
- 如果正则表达式的语法无效Pattern
public String[] split(String regex)
该方法的作用就像是使用给定的表达式和限制参数 0 来调用两参数 split
方法。因此,所得数组中不包括结尾空字符串。
例如,字符串 "boo:and:foo" 使用这些表达式可生成以下结果:
Regex 结果 : { "boo", "and", "foo" } o { "b", "", ":and:f" }
regex
- 定界正则表达式
PatternSyntaxException
- 如果正则表达式的语法无效Pattern
public String toLowerCase(Locale locale)
Locale
的规则将此 String
中的所有字符都转换为小写。大小写映射关系基于 Character
类指定的 Unicode 标准版。由于大小写映射关系并不总是 1:1 的字符映射关系,因此所得 String
的长度可能不同于原 String
。
下表中给出了几个小写映射关系的示例:
语言环境的代码 | 大写字母 | 小写字母 | 描述 |
---|---|---|---|
tr (Turkish) | \u0130 | \u0069 | 大写字母 I,上面有点 -> 小写字母 i |
tr (Turkish) | \u0049 | \u0131 | 大写字母 I -> 小写字母 i,无点 |
(all) | French Fries | french fries | 将字符串中的所有字符都小写 |
(all) | 将字符串中的所有字符都小写 |
locale
- 使用此语言环境的大小写转换规则
String
。toLowerCase()
,
toUpperCase()
,
toUpperCase(Locale)
public String toLowerCase()
String
中的所有字符都转换为小写。这等效于调用 toLowerCase(Locale.getDefault())
。
注: 此方法与语言环境有关,如果用于应独立于语言环境解释的字符串,则可能生成不可预料的结果。
示例有编程语言标识符、协议键、HTML 标记。
例如,"TITLE".toLowerCase()
在 Turkish(土耳其语)语言环境中返回 "t?tle"
,其中“?”是 LATIN SMALL LETTER DOTLESS I 字符。
对于与语言环境有关的字符,要获得正确的结果,请使用 toLowerCase(Locale.ENGLISH)
。
String
。toLowerCase(Locale)
public String toUpperCase(Locale locale)
Locale
的规则将此 String
中的所有字符都转换为大写。大小写映射关系基于 Character
类指定的 Unicode 标准版。由于大小写映射关系并不总是 1:1 的字符映射关系,因此所得 String
的长度可能不同于原 String
。
下表中给出了几个与语言环境有关和 1:M 大小写映射关系的一些示例。
语言环境的代码 | 小写 | 大写 | 描述 |
---|---|---|---|
tr (Turkish) | \u0069 | \u0130 | 小写字母 i -> 大写字母 I,上面有点 |
tr (Turkish) | \u0131 | \u0049 | 小写字母 i,无点 -> 大写字母 I |
(all) | \u00df | \u0053 \u0053 | 小写字母 sharp s -> 两个字母:SS |
(all) | Fahrvergnügen | FAHRVERGNÜN |
locale
- 使用此语言环境的大小写转换规则
String
。toUpperCase()
,
toLowerCase()
,
toLowerCase(Locale)
public String toUpperCase()
String
中的所有字符都转换为大写。此方法等效于 toUpperCase(Locale.getDefault())
。
注: 此方法与语言环境有关,如果用于应独立于语言环境解释的字符串,则可能生成不可预料的结果。
示例有编程语言标识符、协议键、HTML 标记。
例如,"title".toUpperCase()
在 Turkish(土耳其语)语言环境中返回 "T?TLE"
,其中“?”是 LATIN CAPITAL LETTER I WITH DOT ABOVE 字符。
对于与语言环境有关的字符,要获得正确的结果,请使用 toUpperCase(Locale.ENGLISH)
。
String
。toUpperCase(Locale)
public String trim()
如果此 String
对象表示一个空字符序列,或者此 String
对象表示的字符序列的第一个和最后一个字符的代码都大于 '\u0020'
(空格字符),则返回对此 String
对象的引用。
否则,若字符串中没有代码大于 '\u0020'
的字符,则创建并返回一个表示空字符串的新 String
对象。
否则,假定 k 为字符串中代码大于 '\u0020'
的第一个字符的索引,m 为字符串中代码大于 '\u0020'
的最后一个字符的索引。创建一个新的 String
对象,它表示此字符串中从索引 k 处的字符开始,到索引 m 处的字符结束的子字符串,即 this.substring(k, m+1)
的结果。
此方法可用于截去字符串开头和末尾的空白(如上所述)。
public String toString()
CharSequence
中的 toString
Object
中的 toString
public char[] toCharArray()
public static String format(String format, Object... args)
始终使用 Locale.getDefault()
返回的语言环境。
format
- 格式字符串args
- 格式字符串中由格式说明符引用的参数。如果还有格式说明符以外的参数,则忽略这些额外的参数。参数的数目是可变的,可以为 0。参数的最大数目受 Java Virtual Machine Specification 所定义的 Java 数组最大维度的限制。有关 null 参数的行为依赖于转换。
IllegalFormatException
- 如果格式字符串中包含非法语法、与给定的参数不兼容的格式说明符,格式字符串给定的参数不够,或者存在其他非法条件。有关所有可能的格式化错误的规范,请参阅 formatter 类规范的详细信息 一节。
NullPointerException
- 如果 format 为 null
Formatter
public static String format(Locale l, String format, Object... args)
l
- 格式化过程中要应用的语言环境。如果 l 为 null,则不进行本地化。format
- 格式字符串args
- 格式字符串中由格式说明符引用的参数。如果还有格式说明符以外的参数,则忽略这些额外的参数。参数的数目是可变的,可以为 0。参数的最大数目受 Java Virtual Machine Specification 所定义的 Java 数组最大维度的限制。有关 null 参数的行为依赖于转换。
IllegalFormatException
- 如果格式字符串中包含非法语法、与给定参数不兼容的格式说明符,格式字符串给定的参数不够,或存在其他非法条件。有关所有可能的格式化错误的规范,请参阅 formatter 类规范的详细信息 一节。
NullPointerException
- 如果 format 为 null
Formatter
public static String valueOf(Object obj)
Object
参数的字符串表示形式。
obj
- 一个 Object
。
null
,则字符串等于 "null"
;否则,返回 obj.toString()
的值。Object.toString()
public static String valueOf(char[] data)
char
数组参数的字符串表示形式。字符数组的内容已被复制,后续修改不会影响新创建的字符串。
data
- char
数组。
public static String valueOf(char[] data, int offset, int count)
char
数组参数的特定子数组的字符串表示形式。
offset
参数是子数组的第一个字符的索引。count
参数指定子数组的长度。字符数组的内容已被复制,后续修改不会影响新创建的字符串。
data
- 字符数组。offset
- String
值的初始偏移量。count
- String
值的长度。
IndexOutOfBoundsException
- 如果 offset
为负,count
为负,或者 offset+count
大于 data.length
。public static String copyValueOf(char[] data, int offset, int count)
data
- 字符数组。offset
- 子数组的初始偏移量。count
- 子数组的长度。
String
,它包含字符数组的指定子数组的字符。public static String copyValueOf(char[] data)
data
- 字符数组。
String
,它包含字符数组的字符。public static String valueOf(boolean b)
boolean
参数的字符串表示形式。
b
- 一个 boolean
。
true
,则返回一个等于 "true"
的字符串;否则,返回一个等于 "false"
的字符串。public static String valueOf(char c)
char
参数的字符串表示形式。
c
- 一个 char
。
1
的字符串,它包含参数 c
的单个字符。public static String valueOf(int i)
int
参数的字符串表示形式。
该表示形式恰好是单参数的 Integer.toString
方法返回的结果。
i
- 一个 int
。
int
参数的字符串表示形式。Integer.toString(int, int)
public static String valueOf(long l)
long
参数的字符串表示形式。
该表示形式恰好是单参数的 Long.toString
方法返回的结果。
l
- 一个 long
。
long
参数的字符串表示形式。Long.toString(long)
public static String valueOf(float f)
float
参数的字符串表示形式。
该表示形式恰好是单参数的 Float.toString
方法返回的结果。
f
- 一个 float
。
float
参数的字符串表示形式。Float.toString(float)
public static String valueOf(double d)
double
参数的字符串表示形式。
该表示形式恰好是单参数的 Double.toString
方法返回的结果。
d
- 一个 double
。
double
参数的字符串表示形式。Double.toString(double)
public String intern()
一个初始为空的字符串池,它由类 String
私有地维护。
当调用 intern 方法时,如果池已经包含一个等于此 String
对象的字符串(用 equals(Object)
方法确定),则返回池中的字符串。否则,将此 String
对象添加到池中,并返回此 String
对象的引用。
它遵循以下规则:对于任意两个字符串 s
和 t
,当且仅当 s.equals(t)
为 true
时,s.intern() == t.intern()
才为 true
。
所有字面值字符串和字符串赋值常量表达式都使用 intern 方法进行操作。字符串字面值在 Java Language Specification 的 §3.10.5 定义。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。