public final class String
extends Object
implements Serializable, Comparable<String>, CharSequence
java.lang.Object | |
↳ | java.lang.String |
String
类表示字符串。 Java程序中的所有字符串文字(例如"abc"
)都作为"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
定义, Object
Java中的所有类继承。 有关字符串连接和转换的更多信息,请参阅Gosling,Joy和Steele, Java语言规范 。
除非另有说明,否则将 null参数传递给 此类中的构造函数或方法将导致引发 NullPointerException
。
甲String
表示,其中补充字符由代理对表示的UTF-16格式的字符串(请参见第Unicode Character Representations在Character
以获取更多信息类)。 索引值涉及char
代码单元,因此补充字符在String
使用两个位置。
String
类除了处理Unicode代码单元(即 char
值)之外,还提供了处理Unicode代码点(即字符)的方法。
Fields |
|
---|---|
public static final Comparator<String> |
CASE_INSENSITIVE_ORDER 一个比较器,按 |
Public constructors |
|
---|---|
String() 初始化新创建的 |
|
String(String original) 初始化新创建的 |
|
String(char[] value) 分配新的 |
|
String(char[] value, int offset, int count) 分配包含字符数组参数的子数组中的字符的新的 |
|
String(int[] codePoints, int offset, int count) 分配一个新的 |
|
String(byte[] ascii, int hibyte, int offset, int count) 此构造函数在API级别1中已弃用。此方法不会将字节正确转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用 |
|
String(byte[] ascii, int hibyte) 此构造函数在API级别1中已弃用。此方法不会将字节正确转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用 |
|
String(byte[] bytes, int offset, int length, String charsetName) 通过使用指定的字符集解码指定的字节子 |
|
String(byte[] bytes, int offset, int length, Charset charset) |
|
String(byte[] bytes, String charsetName) 构造一个新的 |
|
String(byte[] bytes, Charset charset) 构造一个新的 |
|
String(byte[] bytes, int offset, int length) 通过使用平台的默认字符集解码指定的字节子 |
|
String(byte[] bytes) 通过使用平台的默认字符集解码指定的字节数组构建新的 |
|
String(StringBuffer buffer) 分配一个新字符串,其中包含当前包含在字符串缓冲区参数中的字符序列。 |
|
String(StringBuilder builder) 分配一个新字符串,其中包含当前包含在字符串构建器参数中的字符序列。 |
Public methods |
|
---|---|
char |
charAt(int index) 返回指定索引处的 |
int |
codePointAt(int index) 返回指定索引处的字符(Unicode码点)。 |
int |
codePointBefore(int index) 返回指定索引之前的字符(Unicode码点)。 |
int |
codePointCount(int beginIndex, int endIndex) 返回此 |
int |
compareTo(String anotherString) 按字母顺序比较两个字符串。 |
int |
compareToIgnoreCase(String str) 按字母顺序比较两个字符串,忽略大小写差异。 |
String |
concat(String str) 将指定的字符串连接到此字符串的末尾。 |
boolean |
contains(CharSequence s) 当且仅当此字符串包含指定的char值序列时才返回true。 |
boolean |
contentEquals(StringBuffer sb) 将该字符串与指定的 |
boolean |
contentEquals(CharSequence cs) 将此字符串与指定的 |
static String |
copyValueOf(char[] data, int offset, int count) 返回一个字符串,它表示指定数组中的字符序列。 |
static String |
copyValueOf(char[] data) 返回一个字符串,它表示指定数组中的字符序列。 |
boolean |
endsWith(String suffix) 测试该字符串是否以指定的后缀结尾。 |
boolean |
equals(Object anObject) 将此字符串与指定的对象进行比较。 |
boolean |
equalsIgnoreCase(String anotherString) 将此 |
static String |
format(Locale l, String format, Object... args) 使用指定的区域设置,格式字符串和参数返回格式化的字符串。 |
static String |
format(String format, Object... args) 使用指定的格式字符串和参数返回格式化的字符串。 |
byte[] |
getBytes(String charsetName) 使用指定的字符集将此 |
byte[] |
getBytes() 使用平台的默认字符集将此 |
byte[] |
getBytes(Charset charset) 使用给定的 charset将此 |
void |
getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin) 此方法在API级别1中已弃用。此方法未正确地将字符转换为字节。 从JDK 1.1开始,首选的方法是通过 |
void |
getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) 将此字符串中的字符复制到目标字符数组中。 |
int |
hashCode() 返回此字符串的哈希码。 |
int |
indexOf(int ch, int fromIndex) 返回指定字符首次出现的此字符串内的索引,从指定索引处开始搜索。 |
int |
indexOf(String str) 返回指定子字符串第一次出现的此字符串中的索引。 |
int |
indexOf(int ch) 返回指定字符第一次出现的此字符串中的索引。 |
int |
indexOf(String str, int fromIndex) 从指定索引处开始,返回指定子字符串第一次出现的此字符串中的索引。 |
String |
intern() 返回字符串对象的规范表示形式。 |
boolean |
isEmpty() 返回 true,当且仅当, |
int |
lastIndexOf(int ch) 返回指定字符最后一次出现的字符串中的索引。 |
int |
lastIndexOf(String str, int fromIndex) 返回指定子串的最后一次出现的此字符串中的索引,从指定索引开始向后搜索。 |
int |
lastIndexOf(String str) 返回指定子字符串最后一次出现的此字符串中的索引。 |
int |
lastIndexOf(int ch, int fromIndex) 返回指定字符最后一次出现的此字符串中的索引,从指定索引开始向后搜索。 |
int |
length() 返回此字符串的长度。 |
boolean |
matches(String regex) 告诉这个字符串是否与给定的 regular expression匹配。 |
int |
offsetByCodePoints(int index, int 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(CharSequence target, CharSequence replacement) 将此字符串的每个子字符串替换为指定的文字替换序列的文字目标序列。 |
String |
replace(char oldChar, char newChar) 返回从更换所有出现而产生的新的字符串 |
String |
replaceAll(String regex, String replacement) 用给定的替换替换与给定的 regular expression相匹配的该字符串的每个子字符串。 |
String |
replaceFirst(String regex, String replacement) 用给定的替换替换此字符串的第一个子字符串,该字符串与给定的 regular expression匹配。 |
String[] |
split(String regex, int limit) 将此字符串拆分为给定的 regular expression 。 |
String[] |
split(String regex) 将该字符串拆分为给定的 regular expression的匹配 项 。 |
boolean |
startsWith(String prefix) 测试此字符串是否以指定的前缀开头。 |
boolean |
startsWith(String prefix, int toffset) 测试从指定索引处开始的此字符串的子字符串是否以指定的前缀开头。 |
CharSequence |
subSequence(int beginIndex, int endIndex) 返回一个新的字符序列,该序列是该序列的子序列。 |
String |
substring(int beginIndex, int endIndex) 返回一个新字符串,该字符串是此字符串的一个子字符串。 |
String |
substring(int beginIndex) 返回一个新字符串,该字符串是此字符串的一个子字符串。 |
char[] |
toCharArray() 将此字符串转换为新的字符数组。 |
String |
toLowerCase() 使用默认语言环境的规则将此 |
String |
toLowerCase(Locale locale) 使用给定的 |
String |
toString() 这个对象(它已经是一个字符串!)本身返回。 |
String |
toUpperCase(Locale locale) 使用给定的 |
String |
toUpperCase() 使用默认语言环境的规则将此 |
String |
trim() 返回字符串的副本,省略前导和尾随空白。 |
static String |
valueOf(boolean b) 返回 |
static String |
valueOf(double d) 返回 |
static String |
valueOf(char[] data, int offset, int count) 返回 |
static String |
valueOf(float f) 返回 |
static String |
valueOf(int i) 返回参数 |
static String |
valueOf(char c) 返回 |
static String |
valueOf(long l) 返回 |
static String |
valueOf(Object obj) 返回 |
static String |
valueOf(char[] data) 返回 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface java.lang.Comparable
|
|
From interface java.lang.CharSequence
|
Comparator<String> CASE_INSENSITIVE_ORDER
一个比较器,用compareToIgnoreCase
命令String
对象。 这个比较器是可串行化的。
请注意,此比较器不考虑区域设置,并且会导致某些语言环境的排序不令人满意。 java.text包提供Collators以允许区域设置敏感的排序。
也可以看看:
String (String original)
初始化新创建的String
对象,以便它表示与参数相同的字符序列; 换句话说,新创建的字符串是参数字符串的副本。 除非需要显式拷贝original
,否则不需要使用此构造函数,因为字符串是不可变的。
Parameters | |
---|---|
original |
String : A String |
String (char[] value)
分配新的String
以便它表示当前包含在字符数组参数中的字符序列。 字符数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。
Parameters | |
---|---|
value |
char : The initial value of the string |
String (char[] value, int offset, int count)
分配包含字符数组参数的子数组中的字符的新的String
。 offset
参数是子count
的第一个字符的索引,而count
参数指定子count
的长度。 子数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。
Parameters | |
---|---|
value |
char : Array that is the source of characters |
offset |
int : The initial offset |
count |
int : The length |
Throws | |
---|---|
IndexOutOfBoundsException |
If the offset and count arguments index characters outside the bounds of the value array |
String (int[] codePoints, int offset, int count)
分配一个新的String
,其中包含Unicode code point数组参数的子阵列中的字符 。 offset
参数是子count
的第一个代码点的索引,而count
参数指定子count
的长度。 子阵列的内容转换为char
s; 随后对int
数组进行的修改不会影响新创建的字符串。
Parameters | |
---|---|
codePoints |
int : Array that is the source of Unicode code points |
offset |
int : The initial offset |
count |
int : The length |
Throws | |
---|---|
IllegalArgumentException |
If any invalid Unicode code point is found in codePoints |
IndexOutOfBoundsException |
If the offset and count arguments index characters outside the bounds of the codePoints array |
String (byte[] ascii, int hibyte, int offset, int count)
此构造函数在API级别1中已弃用。
此方法不能正确地将字节转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String
构造函数,该构造函数采用Charset
,字符集名称或使用平台的默认字符集。
分配由8位整数值数组的子阵列构造的新的 String
。
offset
参数是子 count
的第一个字节的索引,而 count
参数指定子 count
的长度。
子 byte
中的每个 byte
按照上述方法中的指定转换为 char
。
Parameters | |
---|---|
ascii |
byte : The bytes to be converted to characters |
hibyte |
int : The top 8 bits of each 16-bit Unicode code unit |
offset |
int : The initial offset |
count |
int : The length |
Throws | |
---|---|
IndexOutOfBoundsException |
If the offset or count argument is invalid |
String (byte[] ascii, int hibyte)
此构造函数在API级别1中已弃用。
此方法不能正确地将字节转换为字符。 从JDK 1.1开始,执行此操作的首选方法是使用String
构造函数,该构造函数使用Charset
,字符集名称或使用平台的默认字符集。
分配一个新的String
其中包含由8位整数值数组String
的字符。 结果字符串中的每个字符c都是由字节数组中的对应组件b构造的,因此:
c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
Parameters | |
---|---|
ascii |
byte : The bytes to be converted to characters |
hibyte |
int : The top 8 bits of each 16-bit Unicode code unit |
String (byte[] bytes, int offset, int length, String charsetName)
通过使用指定的字符集解码指定的字节子String
来构造新的String
。 新的String
的长度是字符集的函数,因此可能不等于子String
的长度。
给定字节在给定字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
offset |
int : The index of the first byte to decode |
length |
int : The number of bytes to decode |
charsetName |
String : The name of a supported charset |
Throws | |
---|---|
UnsupportedEncodingException |
If the named charset is not supported |
IndexOutOfBoundsException |
If the offset and length arguments index characters outside the bounds of the bytes array |
String (byte[] bytes, int offset, int length, Charset charset)
通过使用指定的charset解码指定的字节子String
来构造新的String 。 新的String
的长度是字符集的函数,因此可能不等于子String
的长度。
此方法始终用此字符集的默认替换字符串替换格式错误的输入和不可映射字符序列。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
offset |
int : The index of the first byte to decode |
length |
int : The number of bytes to decode |
charset |
Charset : The charset to be used to decode the bytes |
Throws | |
---|---|
IndexOutOfBoundsException |
If the offset and length arguments index characters outside the bounds of the bytes array |
String (byte[] bytes, String charsetName)
构造一个新的String
由指定用指定的字节的数组解码charset 。 新的String
的长度是字符集的函数,因此可能不等于字节数组的长度。
给定字节在给定字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
charsetName |
String : The name of a supported charset |
Throws | |
---|---|
UnsupportedEncodingException |
If the named charset is not supported |
String (byte[] bytes, Charset charset)
构造一个新的String
由指定用指定的字节的数组解码charset 。 新的String
的长度是字符集的函数,因此可能不等于字节数组的长度。
此方法始终用此字符集的默认替换字符串替换格式错误的输入和不可映射字符序列。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
charset |
Charset : The charset to be used to decode the bytes |
String (byte[] bytes, int offset, int length)
通过使用平台的默认字符集解码指定的字节子String
构建新的String
。 新的String
的长度是字符集的函数,因此可能不等于子String
的长度。
当给定字节在默认字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多的控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
offset |
int : The index of the first byte to decode |
length |
int : The number of bytes to decode |
Throws | |
---|---|
IndexOutOfBoundsException |
If the offset and the length arguments index characters outside the bounds of the bytes array |
String (byte[] bytes)
通过使用平台的默认字符集解码指定的字节数组构建新的String
。 新的String
的长度是charset的函数,因此可能不等于字节数组的长度。
当给定字节在默认字符集中无效时,此构造函数的行为未指定。 当需要对解码过程进行更多控制时,应该使用CharsetDecoder
类。
Parameters | |
---|---|
bytes |
byte : The bytes to be decoded into characters |
String (StringBuffer buffer)
分配一个新字符串,其中包含当前包含在字符串缓冲区参数中的字符序列。 字符串缓冲区的内容被复制; 随后修改字符串缓冲区不会影响新创建的字符串。
Parameters | |
---|---|
buffer |
StringBuffer : A StringBuffer |
String (StringBuilder builder)
分配一个新字符串,其中包含当前包含在字符串构建器参数中的字符序列。 字符串生成器的内容被复制; 随后对字符串生成器的修改不会影响新创建的字符串。
提供此构造函数可轻松迁移到StringBuilder
。 通过toString
方法从字符串构建器获取字符串可能运行得更快,通常是首选。
Parameters | |
---|---|
builder |
StringBuilder : A StringBuilder |
char charAt (int index)
返回指定索引处的值char
。 索引范围从0
到length() - 1
。 序列的第一个char
值位于索引0
,下一个位于索引1
,依此类推,与数组索引相同。
如果索引指定的 char
值为 surrogate ,则返回代理值。
Parameters | |
---|---|
index |
int : the index of the char value. |
Returns | |
---|---|
char |
the char value at the specified index of this string. The first char value is at index 0 . |
Throws | |
---|---|
IndexOutOfBoundsException |
if the index argument is negative or not less than the length of this string. |
int codePointAt (int index)
返回指定索引处的字符(Unicode码点)。 该索引是指char
值(Unicode代码单元),范围从0
到length()
- 1
。
如果给定索引处指定的char
值处于高代理范围内,则以下索引小于此String
的长度,并且以下索引处的char
值位于低代理范围内,则补充代码点对应于这个代理对被返回。 否则,返回给定索引处的char
值。
Parameters | |
---|---|
index |
int : the index to the char values |
Returns | |
---|---|
int |
the code point value of the character at the index |
Throws | |
---|---|
IndexOutOfBoundsException |
if the index argument is negative or not less than the length of this string. |
int codePointBefore (int index)
返回指定索引之前的字符(Unicode码点)。 该索引是指char
值(Unicode代码单元),范围从1
到length
。
如果char
在值(index - 1)
处于低代理项范围, (index - 2)
不为负,并且char
在值(index - 2)
处于高代理项范围,则返回代理对的补充代码点值。 如果char
值为index - 1
是未配对的低代理或高代理,则返回替代值。
Parameters | |
---|---|
index |
int : the index following the code point that should be returned |
Returns | |
---|---|
int |
the Unicode code point value before the given index. |
Throws | |
---|---|
IndexOutOfBoundsException |
if the index argument is less than 1 or greater than the length of this string. |
int codePointCount (int beginIndex, int endIndex)
返回此String
的指定文本范围内的Unicode代码点数。 文本范围始于指定beginIndex
并延伸到char
在索引endIndex - 1
。 因此,文本范围的长度( char
s)为endIndex-beginIndex
。 文本范围内的不配对代理每个计为一个代码点。
Parameters | |
---|---|
beginIndex |
int : the index to the first char of the text range. |
endIndex |
int : the index after the last char of the text range. |
Returns | |
---|---|
int |
the number of Unicode code points in the specified text range |
Throws | |
---|---|
IndexOutOfBoundsException |
if the beginIndex is negative, or endIndex is larger than the length of this String , or beginIndex is larger than endIndex . |
int compareTo (String anotherString)
按字母顺序比较两个字符串。 该比较基于字符串中每个字符的Unicode值。 由此String
对象表示的字符序列按字典顺序与参数字符串表示的字符序列进行比较。 如果这个String
对象按照字典顺序String
在参数字符串之前,那么结果是一个负整数。 如果这个String
对象按照字典顺序跟随参数字符串,那么结果是一个正整数。 如果字符串相等,结果为零; compareTo
正好在equals(Object)
方法返回0
时返回true
。
这是词典排序的定义。 如果两个字符串不同,那么它们在某个索引处具有不同的字符,这是两个字符串的有效索引,或者它们的长度不同,或者两者都有。 如果它们在一个或多个索引位置具有不同的字符,则令k为最小的这样的索引; 那么位置k处的字符具有较小值的字符串,通过使用<运算符确定,按字典顺序排列在另一个字符串之前。 在这种情况下, compareTo
返回两个字符串中位置为k
的两个字符值的k
- 即值:
If there is no index position at which they differ, then the shorter string lexicographically precedes the longer string. In this case,this.charAt(k)-anotherString.charAt(k)
compareTo
returns the difference of the lengths of the strings -- that is, the value:
this.length()-anotherString.length()
Parameters | |
---|---|
anotherString |
String : the String to be compared. |
Returns | |
---|---|
int |
the value 0 if the argument string is equal to this string; a value less than 0 if this string is lexicographically less than the string argument; and a value greater than 0 if this string is lexicographically greater than the string argument. |
int compareToIgnoreCase (String str)
按字母顺序比较两个字符串,忽略大小写差异。 此方法返回一个整数,其符号为调用compareTo
的字符串的标准化版本,其中通过在每个字符上调用Character.toLowerCase(Character.toUpperCase(character))
来消除案例差异。
请注意,此方法不场所考虑,并会导致特定的语言环境不满意的排序。 java.text包提供collators以允许区域设置敏感的排序。
Parameters | |
---|---|
str |
String : the String to be compared. |
Returns | |
---|---|
int |
a negative integer, zero, or a positive integer as the specified String is greater than, equal to, or less than this String, ignoring case considerations. |
也可以看看:
String concat (String str)
将指定的字符串连接到此字符串的末尾。
如果参数字符串的长度为0
,则返回此String
对象。 否则,新String
对象被创建,代表一个字符序列,它是由该表示的字符序列的级联String
对象和由参数字符串表示的字符序列。
例子:
"cares".concat("s") returns "caress" "to".concat("get").concat("her") returns "together"
Parameters | |
---|---|
str |
String : the String that is concatenated to the end of this String . |
Returns | |
---|---|
String |
a string that represents the concatenation of this object's characters followed by the string argument's characters. |
boolean contains (CharSequence s)
当且仅当此字符串包含指定的char值序列时才返回true。
Parameters | |
---|---|
s |
CharSequence : the sequence to search for |
Returns | |
---|---|
boolean |
true if this string contains s , false otherwise |
Throws | |
---|---|
NullPointerException |
if s is null |
boolean contentEquals (StringBuffer sb)
将此字符串与指定的StringBuffer
。 其结果是true
,如果,如果这仅String
表示字符作为指定的相同序列StringBuffer
。
Parameters | |
---|---|
sb |
StringBuffer : The StringBuffer to compare this String against |
Returns | |
---|---|
boolean |
true if this String represents the same sequence of characters as the specified StringBuffer , false otherwise |
boolean contentEquals (CharSequence cs)
将该字符串与指定的CharSequence
。 当且仅当此String
表示与指定序列相同的char值序列时,结果为true
。
Parameters | |
---|---|
cs |
CharSequence : The sequence to compare this String against |
Returns | |
---|---|
boolean |
true if this String represents the same sequence of char values as the specified sequence, false otherwise |
String copyValueOf (char[] data, int offset, int count)
返回一个字符串,它表示指定数组中的字符序列。
Parameters | |
---|---|
data |
char : the character array. |
offset |
int : initial offset of the subarray. |
count |
int : length of the subarray. |
Returns | |
---|---|
String |
a String that contains the characters of the specified subarray of the character array. |
String copyValueOf (char[] data)
返回一个字符串,它表示指定数组中的字符序列。
Parameters | |
---|---|
data |
char : the character array. |
Returns | |
---|---|
String |
a String that contains the characters of the character array. |
boolean endsWith (String suffix)
测试该字符串是否以指定的后缀结尾。
Parameters | |
---|---|
suffix |
String : the suffix. |
Returns | |
---|---|
boolean |
true if the character sequence represented by the argument is a suffix of the character sequence represented by this object; false otherwise. Note that the result will be true if the argument is the empty string or is equal to this String object as determined by the equals(Object) method. |
boolean equals (Object anObject)
将此字符串与指定的对象进行比较。 结果是true
当且仅当参数不是null
并且是一个String
对象,该对象表示与此对象相同的字符序列。
Parameters | |
---|---|
anObject |
Object : The object to compare this String against |
Returns | |
---|---|
boolean |
true if the given object represents a String equivalent to this string, false otherwise |
boolean equalsIgnoreCase (String anotherString)
将此String
与另一个String
比较,忽略大小写注意事项。 如果两个字符串的长度相同,并且两个字符串中的相应字符相同,忽略大小写,则认为两个字符串忽略大小写相等。
如果至少存在以下一种情况,则两个字符 c1
和 c2
被视为相同的忽略情况:
==
operator) toUpperCase(char)
to each character produces the same result toLowerCase(char)
to each character produces the same result Parameters | |
---|---|
anotherString |
String : The String to compare this String against |
Returns | |
---|---|
boolean |
true if the argument is not null and it represents an equivalent String ignoring case; false otherwise |
也可以看看:
String format (Locale l, String format, Object... args)
使用指定的区域设置,格式字符串和参数返回格式化的字符串。
Parameters | |
---|---|
l |
Locale : The locale to apply during formatting. If l is null then no localization is applied. |
format |
String : A format string |
args |
Object : Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by The Java™ Virtual Machine Specification. The behaviour on a null argument depends on the conversion. |
Returns | |
---|---|
String |
A formatted string |
Throws | |
---|---|
|
If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification |
NullPointerException |
If the format is null |
也可以看看:
String format (String format, Object... args)
使用指定的格式字符串和参数返回格式化的字符串。
始终使用的区域设置是由 Locale.getDefault()
返回的区域设置。
Parameters | |
---|---|
format |
String : A format string |
args |
Object : Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by The Java™ Virtual Machine Specification. The behaviour on a null argument depends on the conversion. |
Returns | |
---|---|
String |
A formatted string |
Throws | |
---|---|
|
If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification. |
NullPointerException |
If the format is null |
也可以看看:
byte[] getBytes (String charsetName)
使用指定的字符集将此 String
编码为一个字节序列,并将结果存储到新的字节数组中。
此字符串无法在给定字符集中编码时,此方法的行为未指定。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder
类。
Parameters | |
---|---|
charsetName |
String : The name of a supported charset |
Returns | |
---|---|
byte[] |
The resultant byte array |
Throws | |
---|---|
UnsupportedEncodingException |
If the named charset is not supported |
byte[] getBytes ()
使用平台的默认字符集将此 String
编码为一系列字节,并将结果存储到新的字节数组中。
此字符串不能在默认字符集中编码时,此方法的行为未指定。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder
类。
Returns | |
---|---|
byte[] |
The resultant byte array |
byte[] getBytes (Charset charset)
使用给定的 charset将此 String
编码为一个字节序列,将结果存储到新的字节数组中。
此方法始终用此字符集的默认替换字节数组替换格式错误的输入和不可映射字符序列。 当需要对编码过程进行更多控制时,应该使用CharsetEncoder
类。
Parameters | |
---|---|
charset |
Charset : The Charset to be used to encode the String |
Returns | |
---|---|
byte[] |
The resultant byte array |
void getBytes (int srcBegin, int srcEnd, byte[] dst, int dstBegin)
此方法在API级别1中已弃用。
此方法不能正确地将字符转换为字节。 从JDK 1.1开始,首选的方法是通过getBytes()
方法,该方法使用平台的默认字符集。
将字符串中的字符复制到目标字节数组中。 每个字节接收相应字符的8个低位。 每个字符的八个高位不会被复制,也不会以任何方式参与传输。
要复制的第一个字符位于索引号srcBegin
; 最后要复制的字符位于索引srcEnd-1
。 要复制的字符总数为srcEnd-srcBegin
。 转换为字节的字符被复制到从索引dstBegin
开始到索引dstBegin
结束的dst
子dst
:
dstbegin + (srcEnd-srcBegin) - 1
Parameters | |
---|---|
srcBegin |
int : Index of the first character in the string to copy |
srcEnd |
int : Index after the last character in the string to copy |
dst |
byte : The destination array |
dstBegin |
int : The start offset in the destination array |
Throws | |
---|---|
IndexOutOfBoundsException |
If any of the following is true:
|
void getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin)
将此字符串中的字符复制到目标字符数组中。
要复制的第一个字符位于索引srcBegin
; 要复制的最后一个字符位于索引srcEnd-1
(因此要复制的字符总数为srcEnd-srcBegin
)。 字符被复制到dst
的子dst
从索引dstBegin
开始到索引:
dstbegin + (srcEnd-srcBegin) - 1
Parameters | |
---|---|
srcBegin |
int : index of the first character in the string to copy. |
srcEnd |
int : index after the last character in the string to copy. |
dst |
char : the destination array. |
dstBegin |
int : the start offset in the destination array. |
Throws | |
---|---|
IndexOutOfBoundsException |
If any of the following is true:
|
int hashCode ()
返回此字符串的哈希码。 String
对象的哈希码计算如下
usings[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
int
arithmetic, where
s[i]
is the
ith character of the string,
n
is the length of the string, and
^
indicates exponentiation. (The hash value of the empty string is zero.)
Returns | |
---|---|
int |
a hash code value for this object. |
int indexOf (int ch, int fromIndex)
返回指定字符首次出现的此字符串内的索引,从指定索引处开始搜索。
如果与值的字符ch
在此表示的字符序列发生String
的索引不小于在对象fromIndex
,则返回第一个这样的匹配项的索引。 对于0到0xFFFF(含)范围内的值ch
,这是最小值k ,以便:
is true. For other values of(this.charAt(k) == ch) && (k >= fromIndex)
ch
, it is the smallest value
k such that:
is true. In either case, if no such character occurs in this string at or after position(this.codePointAt(k) == ch) && (k >= fromIndex)
fromIndex
, then
-1
is returned.
fromIndex
的价值没有限制。 如果它是负数,它的效果就好像它为零一样:可以搜索整个字符串。 如果它大于此字符串的长度,则它具有与该字符串的长度相等的效果:返回-1
。
所有索引均以 char
值(Unicode代码单元)指定。
Parameters | |
---|---|
ch |
int : a character (Unicode code point). |
fromIndex |
int : the index to start the search from. |
Returns | |
---|---|
int |
the index of the first occurrence of the character in the character sequence represented by this object that is greater than or equal to fromIndex , or -1 if the character does not occur. |
int indexOf (String str)
返回指定子字符串第一次出现的此字符串中的索引。
返回的索引是最小值 k ,其中:
If no such value of k exists, thenthis.startsWith(str, k)
-1
is returned.
Parameters | |
---|---|
str |
String : the substring to search for. |
Returns | |
---|---|
int |
the index of the first occurrence of the specified substring, or -1 if there is no such occurrence. |
int indexOf (int ch)
返回指定字符第一次出现的此字符串中的索引。 如果在这个String
对象表示的字符序列中出现一个值为ch
的字符,那么返回第一个这样的事件的索引(以Unicode代码为单位)。 对于0到0xFFFF(含)范围内的值ch
,这是最小的值k ,因此:
is true. For other values ofthis.charAt(k) == ch
ch
, it is the smallest value
k such that:
is true. In either case, if no such character occurs in this string, thenthis.codePointAt(k) == ch
-1
is returned.
Parameters | |
---|---|
ch |
int : a character (Unicode code point). |
Returns | |
---|---|
int |
the index of the first occurrence of the character in the character sequence represented by this object, or -1 if the character does not occur. |
int indexOf (String str, int fromIndex)
从指定索引处开始,返回指定子字符串第一次出现的此字符串中的索引。
返回的索引是最小值 k ,其中:
If no such value of k exists, thenk >= fromIndex && this.startsWith(str, k)
-1
is returned.
Parameters | |
---|---|
str |
String : the substring to search for. |
fromIndex |
int : the index from which to start the search. |
Returns | |
---|---|
int |
the index of the first occurrence of the specified substring, starting at the specified index, or -1 if there is no such occurrence. |
String intern ()
返回字符串对象的规范表示形式。
一组字符串,最初是空的,由类 String
私下维护。
当调用实习生方法中,如果池已包含一个字符串等于该String
如由所确定的对象equals(Object)
方法,然后从池中字符串被返回。 否则,将此String
对象添加到池中,并返回对此String
对象的引用。
由此可见,对于任何两个字符串 s
和 t
, s.intern() == t.intern()
为 true
当且仅当 s.equals(t)
为 true
。
所有的文字字符串和字符串值的常量表达式都被禁用。 字符串文字在The Java™ Language Specification的第3.10.5节中定义。
Returns | |
---|---|
String |
a string that has the same contents as this string, but is guaranteed to be from a pool of unique strings. |
boolean isEmpty ()
返回 true,当且仅当, length()
为 0。
Returns | |
---|---|
boolean |
true if length() is 0, otherwise false |
int lastIndexOf (int ch)
返回指定字符最后一次出现的字符串中的索引。 对于0到0xFFFF(含)范围内的值ch
,返回的索引(以Unicode代码单位表示)是最大值k ,因此:
is true. For other values ofthis.charAt(k) == ch
ch
, it is the largest value
k such that:
is true. In either case, if no such character occurs in this string, thenthis.codePointAt(k) == ch
-1
is returned. The
String
is searched backwards starting at the last character.
Parameters | |
---|---|
ch |
int : a character (Unicode code point). |
Returns | |
---|---|
int |
the index of the last occurrence of the character in the character sequence represented by this object, or -1 if the character does not occur. |
int lastIndexOf (String str, int fromIndex)
返回指定子串的最后一次出现的此字符串中的索引,从指定索引开始向后搜索。
返回的索引是最大值 k ,其中:
If no such value of k exists, thenk <= fromIndex && this.startsWith(str, k)
-1
is returned.
Parameters | |
---|---|
str |
String : the substring to search for. |
fromIndex |
int : the index to start the search from. |
Returns | |
---|---|
int |
the index of the last occurrence of the specified substring, searching backward from the specified index, or -1 if there is no such occurrence. |
int lastIndexOf (String str)
返回指定子字符串最后一次出现的此字符串中的索引。 最后一次出现的空字符串“”被认为发生在索引值this.length()
。
返回的索引是最大值 k ,其中:
If no such value of k exists, thenthis.startsWith(str, k)
-1
is returned.
Parameters | |
---|---|
str |
String : the substring to search for. |
Returns | |
---|---|
int |
the index of the last occurrence of the specified substring, or -1 if there is no such occurrence. |
int lastIndexOf (int ch, int fromIndex)
返回指定字符最后一次出现的此字符串中的索引,从指定索引开始向后搜索。 对于范围从0到0xFFFF(含)的ch
值,返回的索引是最大值k ,因此:
is true. For other values of(this.charAt(k) == ch) && (k <= fromIndex)
ch
, it is the largest value
k such that:
is true. In either case, if no such character occurs in this string at or before position(this.codePointAt(k) == ch) && (k <= fromIndex)
fromIndex
, then
-1
is returned.
所有索引均以 char
值(Unicode代码单元)指定。
Parameters | |
---|---|
ch |
int : a character (Unicode code point). |
fromIndex |
int : the index to start the search from. There is no restriction on the value of fromIndex . If it is greater than or equal to the length of this string, it has the same effect as if it were equal to one less than the length of this string: this entire string may be searched. If it is negative, it has the same effect as if it were -1: -1 is returned. |
Returns | |
---|---|
int |
the index of the last occurrence of the character in the character sequence represented by this object that is less than or equal to fromIndex , or -1 if the character does not occur before that point. |
int length ()
返回此字符串的长度。 长度等于字符串中的数字Unicode code units 。
Returns | |
---|---|
int |
the length of the sequence of characters represented by this object. |
boolean matches (String regex)
告诉这个字符串是否与给定的 regular expression匹配。
格式 str .matches( 正则表达式 )的这种方法的调用产生与 表达式完全相同的结果
Pattern
.matches
( regex , str )
Parameters | |
---|---|
regex |
String : the regular expression to which this string is to be matched |
Returns | |
---|---|
boolean |
true if, and only if, this string matches the given regular expression |
Throws | |
---|---|
PatternSyntaxException |
if the regular expression's syntax is invalid |
也可以看看:
int offsetByCodePoints (int index, int codePointOffset)
返回此String
内的索引,该索引与给定的index
codePointOffset
码点。 由index
和codePointOffset
给出的文本范围内的未配对代理每个计为一个代码点。
Parameters | |
---|---|
index |
int : the index to be offset |
codePointOffset |
int : the offset in code points |
Returns | |
---|---|
int |
the index within this String |
Throws | |
---|---|
IndexOutOfBoundsException |
if index is negative or larger then the length of this String , or if codePointOffset is positive and the substring starting with index has fewer than codePointOffset code points, or if codePointOffset is negative and the substring before index has fewer than the absolute value of codePointOffset code points. |
boolean regionMatches (boolean ignoreCase, int toffset, String other, int ooffset, int len)
测试两个字符串区域是否相等。
将此String对象的子字符串与参数other的子字符串进行比较 。 如果这些子字符串表示相同的字符序列,则结果为true ,当且仅当ignoreCase为真时,忽略大小写。 该待比较的String对象的子串从索引toffset开始,长度为len 。 待比较的子串other从索引ooffset开始,长度为len 。 结果是false当且仅当以下至少一个条件成立:
this.charAt(toffset+k) != other.charAt(ooffset+k)
and:Character.toLowerCase(this.charAt(toffset+k)) != Character.toLowerCase(other.charAt(ooffset+k))
Character.toUpperCase(this.charAt(toffset+k)) != Character.toUpperCase(other.charAt(ooffset+k))
Parameters | |
---|---|
ignoreCase |
boolean : if true , ignore case when comparing characters. |
toffset |
int : the starting offset of the subregion in this string. |
other |
String : the string argument. |
ooffset |
int : the starting offset of the subregion in the string argument. |
len |
int : the number of characters to compare. |
Returns | |
---|---|
boolean |
true if the specified subregion of this string matches the specified subregion of the string argument; false otherwise. Whether the matching is exact or case insensitive depends on the ignoreCase argument. |
boolean regionMatches (int toffset, String other, int ooffset, int len)
测试两个字符串区域是否相等。
此String对象的子字符串与参数other的子字符串进行比较。 如果这些子字符串表示相同的字符序列,则结果为真。 此String要比较的对象的子串从索引toffset开始,长度为len 。 其他待比较的子串从索引ooffset开始,长度为len 。 结果是false当且仅当以下至少一个条件成立:
Parameters | |
---|---|
toffset |
int : the starting offset of the subregion in this string. |
other |
String : the string argument. |
ooffset |
int : the starting offset of the subregion in the string argument. |
len |
int : the number of characters to compare. |
Returns | |
---|---|
boolean |
true if the specified subregion of this string exactly matches the specified subregion of the string argument; false otherwise. |
String replace (CharSequence target, CharSequence replacement)
将此字符串的每个子字符串替换为指定的文字替换序列的文字目标序列。 替换从字符串开始到结束,例如,用字符串“aaa”中的“b”替换“aa”将导致“ba”而不是“ab”。
Parameters | |
---|---|
target |
CharSequence : The sequence of char values to be replaced |
replacement |
CharSequence : The replacement sequence of char values |
Returns | |
---|---|
String |
The resulting string |
Throws | |
---|---|
NullPointerException |
if target or replacement is null . |
String replace (char oldChar, char newChar)
返回从更换所有出现而产生的新的字符串 oldChar
,在这个字符串 newChar
。
如果字符oldChar
未出现在由此String
对象表示的字符序列中,则返回对此String
对象的引用。 否则,将创建一个新的String
对象,该对象表示与此String
对象所表示的字符序列相同的字符序列,但每次出现的oldChar
都被替换为newChar
。
例子:
"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)
Parameters | |
---|---|
oldChar |
char : the old character. |
newChar |
char : the new character. |
Returns | |
---|---|
String |
a string derived from this string by replacing every occurrence of oldChar with newChar . |
String replaceAll (String regex, String replacement)
用给定的替换替换与给定的 regular expression相匹配的该字符串的每个子字符串。
格式 str .replaceAll( regex , repl )的这种方法的调用产生与表达式完全相同的结果
Pattern
.compile
( regex ).matcher
( str ).replaceAll
( repl )
请注意替换字符串中的反斜杠( \ )和美元符号( $ )可能会导致结果与将它视为字面替换字符串时的结果不同; 见Matcher.replaceAll
。 如果需要,使用quoteReplacement(String)
来抑制这些字符的特殊含义。
Parameters | |
---|---|
regex |
String : the regular expression to which this string is to be matched |
replacement |
String : the string to be substituted for each match |
Returns | |
---|---|
String |
The resulting String |
Throws | |
---|---|
PatternSyntaxException |
if the regular expression's syntax is invalid |
也可以看看:
String replaceFirst (String regex, String replacement)
用给定的替换替换此字符串的第一个子字符串,该字符串与给定的 regular expression匹配。
格式 str .replaceFirst( regex , repl )的这种方法的调用将产生与表达式完全相同的结果
Pattern
.compile
( regex ).matcher
( str ).replaceFirst
( repl )
请注意替换字符串中的反斜杠( \ )和美元符号( $ )可能会导致结果与将它视为字面替换字符串时的结果不同; 见replaceFirst(String)
。 如果需要,使用quoteReplacement(String)
来抑制这些字符的特殊含义。
Parameters | |
---|---|
regex |
String : the regular expression to which this string is to be matched |
replacement |
String : the string to be substituted for the first match |
Returns | |
---|---|
String |
The resulting String |
Throws | |
---|---|
PatternSyntaxException |
if the regular expression's syntax is invalid |
也可以看看:
String[] split (String regex, int limit)
将该字符串拆分为给定的 regular expression的匹配。
此方法返回的数组包含此字符串的每个子字符串,该字符串由与给定表达式匹配的另一个子字符串终止,或者由字符串的结尾终止。 数组中的子字符串按照它们在此字符串中出现的顺序排列。 如果表达式不匹配输入的任何部分,则结果数组只有一个元素,即该字符串。
limit参数控制模式应用的次数,因此影响结果数组的长度。 如果极限值n大于零,那么模式将最多应用n -1次,数组的长度不会大于n ,并且数组的最后一项将包含超出最后匹配分隔符的所有输入。 如果n是非正值,那么该模式将尽可能多地应用,并且该数组可以具有任何长度。 如果n为零,则模式将尽可能多次应用,数组可以有任意长度,并且尾随的空字符串将被丢弃。
例如,字符串 "boo:and:foo"通过这些参数产生以下结果:
Regex Limit Result : 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( 正则表达式 , n )产生与表达式相同的结果
Pattern
.compile
( regex ).split
( str , n )
Parameters | |
---|---|
regex |
String : the delimiting regular expression |
limit |
int : the result threshold, as described above |
Returns | |
---|---|
String[] |
the array of strings computed by splitting this string around matches of the given regular expression |
Throws | |
---|---|
PatternSyntaxException |
if the regular expression's syntax is invalid |
也可以看看:
String[] split (String regex)
将该字符串拆分为给定的 regular expression 。
此方法的工作原理与通过调用具有给定表达式和极限参数为零的双参数split
方法一样。 尾随的空字符串因此不包含在结果数组中。
例如,字符串 "boo:and:foo"可用以下表达式得出以下结果:
Regex Result : { "boo", "and", "foo" } o { "b", "", ":and:f" }
Parameters | |
---|---|
regex |
String : the delimiting regular expression |
Returns | |
---|---|
String[] |
the array of strings computed by splitting this string around matches of the given regular expression |
Throws | |
---|---|
PatternSyntaxException |
if the regular expression's syntax is invalid |
也可以看看:
boolean startsWith (String prefix)
测试此字符串是否以指定的前缀开头。
Parameters | |
---|---|
prefix |
String : the prefix. |
Returns | |
---|---|
boolean |
true if the character sequence represented by the argument is a prefix of the character sequence represented by this string; false otherwise. Note also that true will be returned if the argument is an empty string or is equal to this String object as determined by the equals(Object) method. |
boolean startsWith (String prefix, int toffset)
测试从指定索引处开始的此字符串的子字符串是否以指定的前缀开头。
Parameters | |
---|---|
prefix |
String : the prefix. |
toffset |
int : where to begin looking in this string. |
Returns | |
---|---|
boolean |
true if the character sequence represented by the argument is a prefix of the substring of this object starting at index toffset ; false otherwise. The result is false if toffset is negative or greater than the length of this String object; otherwise the result is the same as the result of the expression this.substring(toffset).startsWith(prefix) |
CharSequence subSequence (int beginIndex, int endIndex)
返回一个新的字符序列,该序列是该序列的子序列。
这种形式的方法的调用
behaves in exactly the same way as the invocationstr.subSequence(begin, end)
This method is defined so that the String class can implement thestr.substring(begin, end)
CharSequence
interface.
Parameters | |
---|---|
beginIndex |
int : the begin index, inclusive. |
endIndex |
int : the end index, exclusive. |
Returns | |
---|---|
CharSequence |
the specified subsequence. |
Throws | |
---|---|
IndexOutOfBoundsException |
if beginIndex or endIndex are negative, if endIndex is greater than length(), or if beginIndex is greater than startIndex |
String substring (int beginIndex, int endIndex)
返回一个新字符串,该字符串是此字符串的一个子字符串。 子字符串从指定的beginIndex
开始,并延伸到索引号为endIndex - 1
的字符。 因此子字符串的长度是endIndex-beginIndex
。
例子:
"hamburger".substring(4, 8) returns "urge" "smiles".substring(1, 5) returns "mile"
Parameters | |
---|---|
beginIndex |
int : the beginning index, inclusive. |
endIndex |
int : the ending index, exclusive. |
Returns | |
---|---|
String |
the specified substring. |
Throws | |
---|---|
IndexOutOfBoundsException |
if the beginIndex is negative, or endIndex is larger than the length of this String object, or beginIndex is larger than endIndex . |
String substring (int beginIndex)
返回一个新字符串,该字符串是此字符串的一个子字符串。 子字符串以指定索引处的字符开头,并延伸到此字符串的末尾。
例子:
"unhappy".substring(2) returns "happy" "Harbison".substring(3) returns "bison" "emptiness".substring(9) returns "" (an empty string)
Parameters | |
---|---|
beginIndex |
int : the beginning index, inclusive. |
Returns | |
---|---|
String |
the specified substring. |
Throws | |
---|---|
IndexOutOfBoundsException |
if beginIndex is negative or larger than the length of this String object. |
char[] toCharArray ()
将此字符串转换为新的字符数组。
Returns | |
---|---|
char[] |
a newly allocated character array whose length is the length of this string and whose contents are initialized to contain the character sequence represented by this string. |
String toLowerCase ()
使用默认语言环境的规则将此String
所有字符转换为小写。 这相当于拨打toLowerCase(Locale.getDefault())
。
注意:此方法对区域设置非常敏感,如果用于旨在独立解释区域设置的字符串,则可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "TITLE".toLowerCase()
在土耳其语言环境返回"t\u0131tle"
,其中“\ u0131”是拉丁小写字母无点我的性格。 要获得区域设置不敏感字符串的正确结果,请使用toLowerCase(Locale.ENGLISH)
。
Returns | |
---|---|
String |
the String , converted to lowercase. |
也可以看看:
String toLowerCase (Locale locale)
使用给定的Locale
的规则将此String
所有字符转换为Locale
。 案例映射基于Character
类指定的Unicode标准版本。 由于大小写映射并不总是1:1字符映射,因此生成的String
可能与原始String
长度不同。
小写映射的示例如下表所示:
Language Code of Locale | Upper Case | Lower Case | 描述 |
---|---|---|---|
tr (Turkish) | \u0130 | \u0069 | capital letter I with dot above -> small letter i |
tr (Turkish) | \u0049 | \u0131 | capital letter I -> small letter dotless i |
(all) | French Fries | french fries | lowercased all chars in String |
(all) | lowercased all chars in String |
Parameters | |
---|---|
locale |
Locale : use the case transformation rules for this locale |
Returns | |
---|---|
String |
the String , converted to lowercase. |
String toString ()
这个对象(它已经是一个字符串!)本身返回。
Returns | |
---|---|
String |
the string itself. |
String toUpperCase (Locale locale)
使用给定的Locale
的规则将此String
所有字符转换为大写。 案例映射基于Character
类指定的Unicode标准版本。 由于大小写映射并不总是1:1字符映射,因此生成的String
可能与原始String
长度不同。
区域设置敏感和1:M大小写映射的示例如下表所示。
Language Code of Locale | Lower Case | Upper Case | 描述 |
---|---|---|---|
tr (Turkish) | \u0069 | \u0130 | small letter i -> capital letter I with dot above |
tr (Turkish) | \u0131 | \u0049 | small letter dotless i -> capital letter I |
(all) | \u00df | \u0053 \u0053 | small letter sharp s -> two letters: SS |
(all) | Fahrvergnügen | FAHRVERGNÜGEN |
Parameters | |
---|---|
locale |
Locale : use the case transformation rules for this locale |
Returns | |
---|---|
String |
the String , converted to uppercase. |
String toUpperCase ()
使用默认语言环境的规则将此String
所有字符转换为大写。 这种方法相当于toUpperCase(Locale.getDefault())
。
注意:此方法对区域设置非常敏感,如果用于旨在独立解释区域设置的字符串,则可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "title".toUpperCase()
在土耳其语言环境返回"T\u0130TLE"
,其中“\ u0130”是拉丁文大写字母我带点上述特征。 要获得区域设置不敏感字符串的正确结果,请使用toUpperCase(Locale.ENGLISH)
。
Returns | |
---|---|
String |
the String , converted to uppercase. |
也可以看看:
String trim ()
返回字符串的副本,省略前导和尾随空白。
如果此 String
对象表示一个空字符序列,或由该代表字符序列的第一个和最后一个字符 String
对象都具有代码大于 '\u0020'
(空格字符),则此参考 String
被返回对象。
否则,如果字符串中不存在代码大于 '\u0020'
的字符,则会创建并返回代表空字符串的新对象 String
。
否则,令k为代码大于'\u0020'
的字符串中第一个字符的索引,并且让m为代码大于'\u0020'
的字符串中最后一个字符的索引。 将创建一个新的String
对象,该对象表示此字符串的子字符串,该字符串以索引k处的字符开头,并以索引m处的字符结尾 - 即this.substring(k, m+1)
的结果。
该方法可用于从字符串的开始和结尾修剪空白(如上定义)。
Returns | |
---|---|
String |
A copy of this string with leading and trailing white space removed, or this string if it has no leading or trailing white space. |
String valueOf (boolean b)
返回参数 boolean
的字符串表示形式。
Parameters | |
---|---|
b |
boolean : a boolean . |
Returns | |
---|---|
String |
if the argument is true , a string equal to "true" is returned; otherwise, a string equal to "false" is returned. |
String valueOf (double d)
返回 double
参数的字符串表示形式。
该表示正是由一个参数的 Double.toString
方法返回的表示。
Parameters | |
---|---|
d |
double : a double . |
Returns | |
---|---|
String |
a string representation of the double argument. |
也可以看看:
String valueOf (char[] data, int offset, int count)
返回 char
数组参数的特定子阵列的字符串表示形式。
offset
参数是子offset
的第一个字符的索引。 count
参数指定子阵列的长度。 子数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。
Parameters | |
---|---|
data |
char : the character array. |
offset |
int : the initial offset into the value of the String . |
count |
int : the length of the value of the String . |
Returns | |
---|---|
String |
a string representing the sequence of characters contained in the subarray of the character array argument. |
Throws | |
---|---|
IndexOutOfBoundsException |
if offset is negative, or count is negative, or offset+count is larger than data.length . |
String valueOf (float f)
返回 float
参数的字符串表示形式。
该表示法正好是由一个参数的 Float.toString
方法返回的 Float.toString
法。
Parameters | |
---|---|
f |
float : a float . |
Returns | |
---|---|
String |
a string representation of the float argument. |
也可以看看:
String valueOf (int i)
返回 int
参数的字符串表示形式。
该表示法正好是由一个参数的 Integer.toString
方法返回的 Integer.toString
法。
Parameters | |
---|---|
i |
int : an int . |
Returns | |
---|---|
String |
a string representation of the int argument. |
也可以看看:
String valueOf (char c)
返回 char
参数的字符串表示形式。
Parameters | |
---|---|
c |
char : a char . |
Returns | |
---|---|
String |
a string of length 1 containing as its single character the argument c . |
String valueOf (long l)
返回 long
参数的字符串表示形式。
该表示正是由一个参数的 Long.toString
方法返回的表示。
Parameters | |
---|---|
l |
long : a long . |
Returns | |
---|---|
String |
a string representation of the long argument. |
也可以看看:
String valueOf (Object obj)
返回 Object
参数的字符串表示形式。
Parameters | |
---|---|
obj |
Object : an Object . |
Returns | |
---|---|
String |
if the argument is null , then a string equal to "null" ; otherwise, the value of obj.toString() is returned. |
也可以看看:
String valueOf (char[] data)
返回char
数组参数的字符串表示形式。 字符数组的内容被复制; 字符数组的后续修改不会影响新创建的字符串。
Parameters | |
---|---|
data |
char : a char array. |
Returns | |
---|---|
String |
a newly allocated string representing the same sequence of characters contained in the character array argument. |