Java String类Api文档
String类APi文档
常用方法概述
比较相关
返回值类型 | 方法名 | 描述 |
---|---|---|
boolean | contentEquals() | 将此字符串与指定的 StringBuffer 比较。 |
boolean | endsWith(String suffix) | 测试此字符串是否以指定的后缀结束。 |
boolean | startsWith(String prefix) | 测试此字符串是否以指定的前缀开始。 |
int | compareTo(Object o) | 字符串与对象进行比较。 |
int | compareToIgnoreCase(String str) | 按字典顺序比较两个字符串,不考虑大小写 |
boolean | equals(Object anObject) | 将此字符串与指定的对象比较。 |
boolean | equalslgnoreCase(Object anObject) | 与另一个 String 比较,不考虑大小写 |
增删改相关
返回值类型 | 方法名 | 描述 |
---|---|---|
String | concat() | 将指定的字符串参数连接到字符串上 |
String | replace(char oldchar,char newchar) | 将oldchar替换成新的newchar |
String | replaceAll(String regex,String replace) | 匹配正则表达式的字符串替换成新的 |
String | repaceFirst(String regex,String replace) | 替换第一个匹配正则表达式的 |
String | substring(in begin,int end) | 返回字符串的一个子字符串 |
String | toLowerCase() | 将此 String 中的所有字符都转换为小写 |
String | toUpperCase() | 将此 String 中的所有字符都转换为大写 |
转换相关
返回值类型 | 方法名 | 描述 |
---|---|---|
byte[] | getBytes() | String 编码为 byte 序列 |
String[] | split(String regex) | 根据给定正则表达式的匹配拆分此字符串 |
String | copyValueOf(char[] data) | 返回指定数组中表示该字符序列的字符串 |
char[] | toCharArray() | 将此字符串转换为一个新的字符数组。 |
查找相关
返回值类型 | 方法名 | 描述 |
---|---|---|
char | charAt(int index) | 返回指定索引处的字符 |
int | hashCode | 返回此字符串的hash值 |
int | indexOf(String str) | 返回指定子字符串在此字符串中第一次出现处的索引。 |
int | lastIndexOf(String str) | 返回指定字符在此字符串中最后一次出现处的索引 |
其他相关
返回值类型 | 方法名 | 描述 |
---|---|---|
int | length() | 返回此字符串的长度 |
boolean | matc(String regex) | 字符串是否匹配给定的正则表达式 |
String | valueOf | 给定data type类型x参数的字符串表示形式 |
常用方法
文章目录
- String类APi文档
- 常用方法概述
- 常用方法
- @[toc]
- length
- isEmpty
- charAt
- getChars
- getBytes
- getBytes
- getBytes
- getBytes
- getBytes
- equals
- contentEquals
- contentEquals
- contentEquals
- equalsIgnoreCase
- compareTo
- compareToIgnoreCase
- startsWith
- startsWith
- startsWith
- endsWith
- hashCode
- indexOf
- indexOf
- indexOf
- indexOf
- indexOf
- lastIndexOf
- lastIndexOf
- lastIndexOf
- lastIndexOf
- lastIndexOf
- substring
- substring
- substring
- subSequence
- concat
- replace
- replace
- replace
- matches
- replaceFirst
- replaceAll
- split
- split
- split
- join
- join
- join
- toLowerCase
- toLowerCase
- toLowerCase
- toUpperCase
- toUpperCase
- toUpperCase
- trim
- toString
- toCharArray
- format
- format
- format
- copyValueOf
- copyValueOf
- copyValueOf
- valueOf
- valueOf
- valueOf
- valueOf
- valueOf
- valueOf
- valueOf
- valueOf
- intern
length
public int length()
返回此字符串的长度。 长度等于字符串中的数字Unicode code units 。
Specified by:
length
在界面CharSequence
结果
由该对象表示的字符序列的长度。
isEmpty
public boolean isEmpty()
退货 true
如果,只有 length()
是 0
。
结果
true
如果length()
是0
,否则false
从以下版本开始:
1.6
charAt
public char charAt(int index)
返回char
指定索引处的值。指数范围为0
至length() - 1
。该序列的第一个char
值在索引0
,下一个索引为1
,依此类推,与数组索引一样。
如果char
由索引指定的值是surrogate ,则返回所述替代值。
Specified by:
charAt
在界面CharSequence
参数
index
-char
值的指数。结果
所述
char
此字符串的指定索引处的值。 第一个char
值是索引0
。异常
IndexOutOfBoundsException
- 如果index
参数为负数或不小于此字符串的长度。
getChars
public void getChars(int srcBegin,int srcEnd,char[] dst,int dstBegin)
将此字符串中的字符复制到目标字符数组中。
要复制的第一个字符是索引srcBegin
; 要复制的最后一个字符在索引srcEnd-1
(因此要复制的srcEnd-srcBegin
总数为srcEnd-srcBegin
)。 字符被复制到的子阵列dst
开始于索引dstBegin
和在索引结束:
dstbegin + (srcEnd-srcBegin) - 1
参数
srcBegin
- 要复制的字符串中第一个字符的索引。srcEnd
- 要复制的字符串中最后一个字符后面的索引。dst
- 目标数组。dstBegin
- 目标数组中的起始偏移量。异常
IndexOutOfBoundsException
- 如果满足以下条件:srcBegin
为负数。srcBegin
大于srcEnd
srcEnd
大于此字符串的长度dstBegin
为负数dstBegin+(srcEnd-srcBegin)
大于dst.length
getBytes
getBytes
@Deprecated
public void getBytes(int srcBegin,int srcEnd,byte[] dst,int dstBegin)
已弃用 此方法无法将字符正确转换为字节。 从JDK 1.1开始,首选的方法是通过getBytes()
方法,它使用平台的默认字符集。
将此字符串中的字符复制到目标字节数组中。每个字节接收相应字符的8个低位。每个字符的八个高位不被复制,也不以任何方式参与转移。
要复制的第一个字符是索引srcBegin
; 要复制的最后一个字符在索引srcEnd-1
。 要复制的srcEnd-srcBegin
总数为srcEnd-srcBegin
。 转换为字节的字符被复制到dst
的子阵列中,从索引dstBegin
开始,以索引结尾:
dstbegin + (srcEnd-srcBegin) - 1
参数
srcBegin
- 要复制的字符串中第一个字符的索引srcEnd
- 要复制的字符串中最后一个字符后的索引dst
- 目的数组dstBegin
- 目标数组中的起始偏移量异常
IndexOutOfBoundsException
- 如果满足以下条件:srcBegin
为负数srcBegin
大于srcEnd
srcEnd
大于此String的长度dstBegin
为负数dstBegin+(srcEnd-srcBegin)
大于dst.length
getBytes
public byte[] getBytes(String charsetName)throws UnsupportedEncodingException
使用命名的字符集将此String
编码为字节序列,将结果存储到新的字节数组中。
此字符串不能在给定字符集中编码时,此方法的行为是未指定的。 当需要对编码过程进行更多控制时,应使用CharsetEncoder
类。
参数
charsetName
- 支持的名称charset结果
结果字节数组
异常
UnsupportedEncodingException
- 如果不支持命名的字符集从以下版本开始:
JDK1.1
getBytes
public byte[] getBytes(Charset charset)
使用给定的charset将该String
编码为一个字节序列,将结果存储到新的字节数组中。
此方法总是用此字符集的默认替换字节数组替换格式错误的输入和不可映射字符序列。 当需要对编码过程的更多控制时,应使用CharsetEncoder
类。
参数
charset
-该Charset被用于编码String
结果
结果字节数组
从以下版本开始:
1.6
getBytes
public byte[] getBytes()
使用平台的默认字符集将此String
编码为字节序列,将结果存储到新的字节数组中。
当该字符串不能在默认字符集中编码时,此方法的行为是未指定的。 当需要对编码过程进行更多控制时,应使用CharsetEncoder
类。
结果
结果字节数组
从以下版本开始:
JDK1.1
equals
public boolean equals(Object anObject)
将此字符串与指定对象进行比较。 其结果是true
当且仅当该参数不是null
并且是String
对象,表示相同的字符序列作为该对象。
重写:
equals
在Object
参数
anObject
- 对比这个String
的对象结果
true
如果给定的对象代表一个String
等效于这个字符串,false
否则另请参见:
compareTo(String)
,equalsIgnoreCase(String)
contentEquals
contentEquals
public boolean contentEquals(StringBuffer sb)
将此字符串与指定的StringBuffer进行StringBuffer
。 其结果是true
如果并且如果该只String
表示的字符作为指定的相同序列StringBuffer
。 该方法在StringBuffer上StringBuffer
。
参数
sb
-StringBuffer
将此String
对比结果
true
如果此String
表示相同的字符序列作为指定StringBuffer
,false
否则从以下版本开始:
1.4
contentEquals
public boolean contentEquals(CharSequence cs)
将此字符串与指定的CharSequence进行CharSequence
。 其结果是true
如果并且如果该只String
表示char值的相同序列与指定序列。 请注意,如果CharSequence
是StringBuffer
那么该方法将同步它。
参数
cs
- 比较这个String
的序列结果
true
如果这个String
表示与指定序列相同的char值序列,false
否则从以下版本开始:
1.5
equalsIgnoreCase
public boolean equalsIgnoreCase(String anotherString)
将此String
与其他String
比较,忽略案例注意事项。如果两个字符串的长度相同,并且两个字符串中的相应字符等于忽略大小写,则两个字符串被认为是相等的。
如果以下至少一个为真,则两个字符c1
和c2
被认为是相同的忽略情况:
两个字符相同(与
==
操作符相比)将方法
Character.toUpperCase(char)
应用于每个字符产生相同的结果将方法
Character.toLowerCase(char)
应用于每个字符产生相同的结果参数
anotherString
-String
将此String
对比结果
true
如果参数不是null
,它代表等效的String
忽略大小写;false
否则另请参见:
equals(Object)
compareTo
public int compareTo(String anotherString)
按字典顺序比较两个字符串。比较是基于字符串中每个字符的Unicode值。由该String
对象表示的字符序列按字典顺序与由参数字符串表示的字符序列进行比较。如果String
对象按字典顺序排列在参数字符串之前,结果为负整数。结果是一个正整数,如果String
对象按字典顺序跟随参数字符串。如果字符串相等,结果为零;compareTo
返回0
,当equals(Object)
方法将返回true
。
这是字典排序的定义。 如果两个字符串不同,则它们在某些索引处具有不同的字符,这两个字符串是两个字符串的有效索引,或者它们的长度不同,或两者都是不同的。 如果它们在一个或多个索引位置具有不同的字符,则令k为最小的索引; 那么在位置k处的字符具有较小值的字符串,如通过使用<运算符确定的,以字典顺序位于另一个字符串之前。 在这种情况下, compareTo
返回两个字符串中位置k
处的两个字符值的差值,即值:
this.charAt(k)-anotherString.charAt(k)
如果没有它们不同的索引位置,则较短的字符串按字典顺序位于较长的字符串之前。在这种情况下, compareTo
返回字符串长度的差异 - 即值:
this.length()-anotherString.length()
Specified by:
compareTo
在界面Comparable<String>
参数
anotherString
- 要比较的String
。结果
如果参数字符串等于此字符串,则值为
0
; 一个值小于0
如果这个字符串的字典比字符串参数小; 如果此字符串的字典大小超过字符串参数,则值大于0
。
compareToIgnoreCase
public int compareToIgnoreCase(String str)
按字典顺序比较两个字符串,忽略病例差异。此方法返回一个整数,其标志是调用的compareTo
与在不同的情况下已经被淘汰,通过调用字符串的规范化版本Character.toLowerCase(Character.toUpperCase(character))
上的每一个字符。
请注意,此方法不场所考虑,并会导致特定的语言环境不满意的排序。 java.text包提供了整理器来允许区域设置敏感的排序。
参数
str
- 要比较的String
。结果
指定的String大于等于或小于此String的负整数,零或正整数,忽略大小写注意事项。
从以下版本开始:
1.2
另请参见:
Collator.compare(String, String)
startsWith
startsWith
public boolean startsWith(String prefix,int toffset)
测试在指定索引处开始的此字符串的子字符串是否以指定的前缀开头。
参数
prefix
- 前缀。toffset
- 在哪里开始查找这个字符串。结果
true
如果由参数表示的字符序列是从索引toffset
开始的此对象的子字符串的前缀;false
否则。 如果toffset
为负数或大于此String
对象的长度,则结果为false
; 否则结果与表达式的结果相同this.substring(toffset).startsWith(prefix)
startsWith
public boolean startsWith(String prefix)
测试此字符串是否以指定的前缀开头。
参数
prefix
- 前缀。结果
true
如果由参数表示的字符序列是由该字符串表示的字符序列的前缀;false
否则。 还需要注意的是true
如果参数为空字符串或等于该将被返回String
如由所确定的对象equals(Object)
方法。从以下版本开始:
- 0
endsWith
public boolean endsWith(String suffix)
测试此字符串是否以指定的后缀结尾。
参数
suffix
- 后缀。结果
true
如果由参数表示的字符序列是由该对象表示的字符序列的后缀;false
否则。 注意,结果将是true
如果参数是空字符串或等于该String
如由所确定的对象equals(Object)
方法。
hashCode
public int hashCode()
返回此字符串的哈希码。String
对象的哈希代码计算为
s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
使用int
算术,其中s[i]
是字符串的第i个字符, n
是字符串的长度, ^
表示取幂。(空字符串的哈希值为零)
重写:
hashCode
在类别Object
结果
该对象的哈希码值。
另请参见:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
indexOf
indexOf
public int indexOf(int ch)
返回指定字符第一次出现的字符串内的索引。如果与值的字符ch
在此表示的字符序列发生String
第一事件发生之对象,则索引(在Unicode代码单元)被返回。对于从0到0xFFFF(含)范围内的ch
的值,这是最小值k ,使得:
this.charAt(*k*) == ch
是真的。对于ch
其他值,它是最小值k ,使得:
this.codePointAt(*k*) == ch
是真的。在这两种情况下,如果此字符串中没有此类字符,则返回-1
。
参数
ch
- 一个字符(Unicode代码点)。结果
在通过该对象表示的字符序列的字符的第一次出现的索引,或
-1
如果字符不会发生。indexOf
public int indexOf(int ch,int fromIndex)
返回指定字符第一次出现的字符串内的索引,以指定的索引开始搜索。
如果与值的字符ch
在此表示的字符序列发生String
的索引不小于在对象fromIndex
,则返回第一个这样的匹配项的索引。 对于从0到0xFFFF(含)范围内的ch
的值,这是最小值k ,使得:
(this.charAt(*k*) == ch) && (*k* >= fromIndex)
是真的。对于ch
其他值,它是最小值k ,使得:
(this.codePointAt(*k*) == ch) && (*k* >= fromIndex)
是真的。在这两种情况下,如果这个字符串在位置fromIndex
之间或之后没有出现,则返回-1
。
fromIndex的价值没有fromIndex
。 如果它是否定的,它具有与零一样的效果:可以搜索整个字符串。 如果它大于此字符串的长度,它具有与该字符串的长度相等的效果: -1
被返回。
所有索引在char
值(Unicode代码单位)中char
。
参数
ch
- 一个字符(Unicode代码点)。fromIndex
- 开始搜索的索引。结果
在通过该对象,它是大于或等于表示的字符序列的字符的第一次出现的索引
fromIndex
,或-1
如果不发生的字符。indexOf
public int indexOf(String str)
返回指定子字符串第一次出现的字符串内的索引。
返回的索引是其中的最小值k :
this.startsWith(str, *k*)
如果k的值不存在,则返回-1
。
参数
str
- 要搜索的子字符串。结果
指定的子串,或第一次出现的索引
-1
如果不存在这样的发生。indexOf
public int indexOf(String str,int fromIndex)
返回指定子串的第一次出现的字符串中的索引,从指定的索引开始。
返回的索引是其中的最小值k :
*k* >= fromIndex && this.startsWith(str, *k*)
如果不存在这样的k值,则返回-1
。
参数
str
- 要搜索的子字符串。fromIndex
- 从fromIndex
开始搜索的索引。结果
指定的字符串的第一个出现的索引,开始指定索引处,或
-1
如果不存在这样的发生。
lastIndexOf
lastIndexOf
public int lastIndexOf(int ch)
返回指定字符的最后一次出现的字符串中的索引。对于从0到0xFFFF(含)范围内的ch
的值, ch
的索引(以Unicode代码为单位)是最大的值k ,使得:
this.charAt(*k*) == ch
是真的。对于ch
其他值,它是最大值k ,使得:
this.codePointAt(*k*) == ch
是真的。在任何一种情况下,如果此字符串中没有此类字符,则返回-1
。String从最后一个字符开始String
搜索。
参数
ch
- 一个字符(Unicode代码点)。结果
在通过该对象表示的字符序列的字符的最后一次出现的索引,或
-1
如果字符不会发生。lastIndexOf
public int lastIndexOf(int ch,int fromIndex)
返回指定字符的最后一次出现的字符串中的索引,从指定的索引开始向后搜索。对于从0到0xFFFF(含)范围内的ch
的值,返回的索引是最大值k ,使得:
(this.charAt(*k*) == ch) && (*k* <= fromIndex)
是真的。对于ch
其他值,它是最大的值k ,使得:
(this.codePointAt(*k*) == ch) && (*k* <= fromIndex)
是真的。在这两种情况下,如果此字符串在位置fromIndex
之前或之后没有出现这样的字符,则返回-1
。
所有索引在char
值(Unicode代码单位)中char
。
参数
ch
- 一个字符(Unicode代码点)。fromIndex
- 开始搜索的索引。 对fromIndex的价值没有fromIndex
。 如果它大于或等于该字符串的长度,它具有与等于该字符串长度小于1的效果相同的效果:可以搜索整个字符串。 如果它是负的,它具有与-1:-1相同的效果。结果
在通过该对象,它是小于或等于表示的字符序列的字符的最后一次出现的索引
fromIndex
,或-1
如果该字符不该点之前发生。lastIndexOf
public int lastIndexOf(String str)
返回指定子字符串最后一次出现的字符串中的索引。空字符串“”的最后一次出现被认为发生在索引值this.length()
。
返回的索引是其中的最大值k :
this.startsWith(str, *k*)
如果没有k的值存在,则返回-1
。
参数
str
- 要搜索的子字符串。结果
指定的子串,或最后一次出现的索引
-1
如果不存在这样的发生。lastIndexOf
public int lastIndexOf(String str,int fromIndex)
返回指定子字符串的最后一次出现的字符串中的索引,从指定索引开始向后搜索。
返回的索引是其中的最大值k :
*k* <= fromIndex && this.startsWith(str, *k*)
如果k的值不存在,则返回-1
。
参数
str
- 要搜索的子字符串。fromIndex
- 开始搜索的索引。结果
指定子字符串的最后一个匹配的索引,从指定的索引,或向后搜索
-1
如果不存在这样的发生。
substring
substring
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
对象的长度。substring
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
。
subSequence
public CharSequence subSequence(int beginIndex,int endIndex)
返回一个字符序列,该序列是该序列的子序列。
调用此方法的形式
str.subSequence(begin, end)
行为与调用完全相同
str.substring(begin, end)
Specified by:
subSequence
在界面CharSequence
API Note:
该方法定义为
String
类可以实现CharSequence
接口。参数
beginIndex
- 开始索引,包括。endIndex
- 结束索引,排他。结果
指定的子序列。
异常
IndexOutOfBoundsException
- 如果beginIndex
或endIndex
为负数,如果endIndex
大于length()
,或者如果beginIndex
大于endIndex
从以下版本开始:
1.4
concat
public String concat(String str)
将指定的字符串连接到该字符串的末尾。
如果参数字符串的长度为0
,则返回此String
对象。 否则,返回一个String
对象,表示一个字符序列,该字符序列是由该String
对象表示的字符序列与由参数字符串表示的字符序列的级联。
例子:
"cares".concat("s") returns "caress" "to".concat("get").concat("her") returns "together"
参数
str
-String
被连接到这个String
。结果
一个字符串,表示此对象的字符后跟字符串参数的字符的并置。
replace
replace
public String replace(char oldChar,char newChar)
返回从替换所有出现的导致一个字符串oldChar
在此字符串newChar
。
如果在String 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)
参数
oldChar
- 老字。newChar
- 新角色。结果
通过替换的每次出现从这个串衍生出的字符串
oldChar
与newChar
。replace
public String replace(CharSequence target,CharSequence replacement)
将与字面目标序列匹配的字符串的每个子字符串替换为指定的字面替换序列。 替换从字符串开始到结束,例如,在字符串“aaa”中用“b”替换“aa”将导致“ba”而不是“ab”。
参数
target
- 要替换的char值序列replacement
- char值的替换顺序结果
生成的字符串
从以下版本开始:
1.5
matches
public boolean matches(String regex)
告诉这个字符串是否匹配给定的regular expression 。
这种形式为str .matches(
regex )
方法的)
产生与表达式完全相同的结果
Pattern
.matches(*regex*, *str*)
参数
regex
- 要匹配此字符串的正则表达式结果
true
如果,并且只有这个字符串与给定的正则表达式匹配异常
PatternSyntaxException
- 如果正则表达式的语法无效从以下版本开始:
1.4
另请参见:
Pattern
replaceFirst
public String replaceFirst(String regex,String replacement)
用给定的替换替换与给定的regular expression匹配的此字符串的第一个子字符串。
这种形式为str .replaceFirst(
regex ,
repl )
方法的)
产生与表达式完全相同的结果
Pattern.compile(*regex*).matcher(*str*).replaceFirst(*repl*)
请注意,替换字符串中的反斜杠( \
)和美元符号( $
)可能会导致结果与被视为文字替换字符串时的结果不同; 见Matcher.replaceFirst(java.lang.String)
。 如果需要,使用Matcher.quoteReplacement(java.lang.String)
来抑制这些字符的特殊含义。
参数
regex
- 要匹配此字符串的正则表达式replacement
- 要替换第一个匹配的字符串结果
结果
String
异常
PatternSyntaxException
- 如果正则表达式的语法无效从以下版本开始:
1.4
另请参见:
Pattern
replaceAll
public String replaceAll(String regex,String replacement)
用给定的替换替换与给定的regular expression匹配的此字符串的每个子字符串。
这种形式为str .replaceAll(
regex ,
repl )
方法的)
产生与表达式完全相同的结果
Pattern.compile(*regex*).matcher(*str*).replaceAll(*repl*)
请注意,替换字符串中的反斜杠( \
)和美元符号( $
)可能会导致结果与被视为文字替换字符串时的结果不同; 见Matcher.replaceAll
。 如果需要,使用Matcher.quoteReplacement(java.lang.String)
来抑制这些字符的特殊含义。
参数
regex
- 要匹配此字符串的正则表达式replacement
- 要替换每个匹配的字符串结果
所得
String
异常
PatternSyntaxException
- 如果正则表达式的语法无效从以下版本开始:
1.4
另请参见:
Pattern
split
split
public String[] split(String regex,int limit)
将此字符串拆分为给定的regular expression的匹配。
此方法返回的数组包含此字符串的每个子字符串,该字符串由与给定表达式匹配的另一个子字符串终止,或由字符串结尾终止。 数组中的子字符串按照它们在此字符串中的顺序排列。 如果表达式与输入的任何部分不匹配,则生成的数组只有一个元素,即这个字符串。
当在此字符串的开始处存在正宽度匹配时,在结果数组的开始处包含空的前导子字符串。 开始时的零宽度匹配不会产生这样的空的前导子串。
limit
参数控制应用模式的次数,因此影响生成的数组的长度。 如果极限n大于0,则模式最多应用n -1次,数组的长度不大于n ,数组的最后一个条目将包含超出最后一个匹配分隔符的所有输入。 如果n是非正的,那么模式将被应用到尽可能多的次数,并且数组可以有任何长度。 如果n为0,则模式将被应用尽可能多次,数组可以有任何长度,并且尾随的空字符串将被丢弃。
例如,字符串"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*)
参数
regex
- 分隔正则表达式limit
- 结果阈值,如上所述结果
通过将该字符串围绕给定的正则表达式的匹配来计算的字符串数组
异常
PatternSyntaxException
- 如果正则表达式的语法无效从以下版本开始:
1.4
另请参见:
Pattern
split
public String[] split(String regex)
将此字符串拆分为给定的regular expression的匹配。
该方法的工作原理是通过使用给定表达式和限制参数为零调用双参数split
方法。 因此,尾随的空字符串不会包含在结果数组中。
例如,字符串"boo:and:foo"
使用以下表达式得到以下结果:
Regex Result :
{ "boo", "and", "foo" }
o{ "b", "", ":and:f" }
参数
regex
- 分隔正则表达式结果
通过将该字符串围绕给定的正则表达式的匹配来计算的字符串数组
异常
PatternSyntaxException
- 如果正则表达式的语法无效从以下版本开始:
1.4
另请参见:
Pattern
join
join
public static String join(CharSequence delimiter,CharSequence... elements)
返回一个新的字符串,由CharSequence elements
的副本组成,并附有指定的delimiter的delimiter
。
For example,
String message = String.join("-", "Java", "is", "cool"); // message returned is: "Java-is-cool"
请注意,如果元素为空,则添加"null"
。
参数
delimiter
- 分隔每个元素的分隔符elements
- 要加入的元素。结果
一个新的
String
,其由所述的elements
由分离delimiter
异常
NullPointerException
- 如果delimiter
或elements
是null
从以下版本开始:
1.8
另请参见:
StringJoiner
join
public static String join(CharSequence delimiter,Iterable<? extends CharSequence> elements)
返回一个新String
的副本组成CharSequence elements
与指定的副本一起加入delimiter
。
For example,
List<String> strings = new LinkedList<>(); strings.add("Java");strings.add("is"); strings.add("cool"); String message = String.join(" ", strings); //message returned is: "Java is cool" Set<String> strings = new LinkedHashSet<>(); strings.add("Java"); strings.add("is"); strings.add("very"); strings.add("cool"); String message = String.join("-", strings); //message returned is: "Java-is-very-cool"
请注意,如果单个元素为null
,则添加"null"
。
参数
delimiter
- 用于分离elements
中的每一个的elements
序列String
elements
- 一个Iterable
,将其elements
连接在一起。结果
一个新的
String
由elements
参数组成异常
NullPointerException
- 如果delimiter
或elements
是null
从以下版本开始:
1.8
另请参见:
join(CharSequence,CharSequence...)
,StringJoiner
toLowerCase
toLowerCase
public String toLowerCase(Locale locale)
将所有在此字符String
,以降低使用给定的规则情况下Locale
。案例映射基于Character
类指定的Unicode标准版本。由于情况的映射并不总是1:1字符映射,将所得String
可以是不同的长度比原来的String
。
参数
locale
- 使用此区域设置的案例转换规则结果
String
,转换成小写。从以下版本开始:
1.1
另请参见:
toLowerCase()
,toUpperCase()
,toUpperCase(Locale)
toLowerCase
public String toLowerCase()
将所有在此字符String
使用默认语言环境的规则,以小写。这相当于打电话toLowerCase(Locale.getDefault())
。
**注意:**此方法是区域设置敏感的,如果用于单独解释区域设置的字符串,可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "TITLE".toLowerCase()
在土耳其语言环境返回"t\u0131tle"
,其中“\ u0131”是拉丁小写字母无点我的性格。 要获取区域设置不敏感字符串的正确结果,请使用toLowerCase(Locale.ROOT)
。
结果
String
,转换成小写。另请参见:
toLowerCase(Locale)
toUpperCase
toUpperCase
public String toUpperCase(Locale locale)
将所有在此字符String
使用给定的规则,大写Locale
。案例映射基于Character
类指定的Unicode标准版本。由于案例映射并不总是1:1的字符映射,所以String
可能与原始的String
。
区域设置敏感和1:M情况映射的示例如下表所示。
Language Code of Locale Lower Case Upper Case Description 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
参数
locale
- 使用此区域设置的案例转换规则结果
String
,转换成大写。从以下版本开始:
1.1
另请参见:
toUpperCase()
,toLowerCase()
,toLowerCase(Locale)
toUpperCase
public String toUpperCase()
使用默认语言环境的规则将此String
中的所有字符转换为大写。此方法相当于toUpperCase(Locale.getDefault())
。
**注意:**此方法是区域设置敏感的,如果用于单独解释区域设置的字符串,可能会产生意外的结果。 示例是编程语言标识符,协议密钥和HTML标签。 例如, "title".toUpperCase()
在土耳其语言环境返回"T\u0130TLE"
,其中“\ u0130”是拉丁文大写字母我带点上述特征。 要获得不区分大小写字符串的正确结果,请使用toUpperCase(Locale.ROOT)
。
结果
的
String
,转换为大写。另请参见:
toUpperCase(Locale)
trim
public String trim()
返回一个字符串,其值为此字符串,并删除任何前导和尾随空格。
如果此String
对象表示一个空字符序列,或由该代表字符序列的第一个和最后一个字符String
对象都具有代码大于'\u0020'
(空格字符),则此参考String
被返回对象。
否则,如果字符串中没有字符大于'\u0020'
的字符,则返回一个表示空字符串的String
对象。
否则,令k为代码大于’\u0020’的字符串中第一个字符的'\u0020'
,并且m为代码大于'\u0020'
的字符串中最后一个字符的'\u0020'
。 将返回一个String
对象,表示该字符串的子字符串,以索引k处的字符开头,以索引m为止的字符结束,结果为this.substring(k, m + 1)
。
此方法可用于从字符串的开始和结尾修剪空格(如上定义)。
结果
一个字符串,其值是此字符串,除去任何前导和尾随空格,或者如果该字符串没有前导或尾随的空格,则为该字符串。
toString
public String toString()
此对象(已经是字符串!)本身已被返回。
Specified by:
toString
在界面CharSequence
重写:
toString
在类别Object
结果
字符串本身。
toCharArray
public char[] toCharArray()
将此字符串转换为新的字符数组。
结果
一个新分配的字符数组,其长度是该字符串的长度,其内容被初始化为包含由该字符串表示的字符序列。
format
format
public static String format(String format,Object... args)
使用指定的格式字符串和参数返回格式化的字符串。
总是使用的区域是Locale.getDefault()
返回的地方 。
参数
format
- A format stringargs
- 格式字符串中格式说明符引用的参数。 如果比格式说明符更多的参数,额外的参数将被忽略。 参数的数量是可变的,可能为零。 参数的最大数量受限于The Java™ Virtual Machine Specification定义的Java数组的最大维数 。 一个null
参数的行为取决于conversion 。结果
格式化的字符串
异常
IllegalFormatException
- 如果格式字符串包含非法语法,则与给定参数不兼容的格式说明符,给定格式字符串的参数不足或其他非法条件。 有关所有可能的格式化错误的规范 ,请参阅格式化程序类规范的Details部分。从以下版本开始:
1.5
另请参见:
Formatter
format
public static String format(Locale l,String format,Object... args)
使用指定的区域设置,格式字符串和参数返回格式化的字符串。
参数
l
- 格式化期间应用的locale。 如果l
是null
,则不应用本地化。format
- A format stringargs
- 格式字符串中格式说明符引用的参数。 如果比格式说明符更多的参数,额外的参数将被忽略。 参数的数量是可变的,可能为零。 参数的最大数量受到The Java™ Virtual Machine Specification定义的Java数组的最大维度的限制 。 一个null
参数的行为取决于conversion 。结果
格式化的字符串
异常
IllegalFormatException
- 如果格式字符串包含非法语法,则与给定参数不兼容的格式说明符,给定格式字符串的参数不足或其他非法条件。 有关所有可能的格式化错误的规范 ,请参阅格式化程序类规范的Details部分从以下版本开始:
1.5
另请参见:
Formatter
copyValueOf
copyValueOf
public static String copyValueOf(char[] data,int offset,int count)
相当于 valueOf(char[\], int, int)
。
参数
data
- 字符数组。offset
- 子阵列的初始偏移量。count
- 子阵列的长度。结果
一个
String
,其中包含字符数组的指定子阵列的字符。异常
IndexOutOfBoundsException
- 如果offset
为负数,或count
为负数,或offset+count
大于data.length
。copyValueOf
public static String copyValueOf(char[] data)
相当于 valueOf(char[\])
。
参数
data
- 字符数组。结果
一个
String
包含字符阵列的字符。
valueOf
valueOf
public static String valueOf(int i)
返回int
参数的字符串int
形式。
该表示恰好是一个参数的Integer.toString
方法返回的表示。
参数
i
-int
。结果
一个字符串表示的
int
参数。另请参见:
Integer.toString(int, int)
valueOf
public static String valueOf(long l)
返回long
参数的字符串long
形式。
该表示恰好是一个参数的Long.toString
方法返回的表示。
参数
l
- along
。结果
一个字符串表示的
long
参数。另请参见:
Long.toString(long)
valueOf
public static String valueOf(float f)
返回float
参数的字符串float
形式。
该表示恰好是一个参数的Float.toString
方法返回的表示。
参数
f
- afloat
。结果
float
参数的字符串表示。另请参见:
Float.toString(float)
valueOf
public static String valueOf(double d)
返回double
参数的字符串double
形式。
该表示恰好是一个参数的Double.toString
方法返回的表示。
参数
d
- adouble
。结果
double
参数的字符串double
形式。另请参见:
Double.toString(double)
valueOf
public static String valueOf(Object obj)
返回 Object
参数的字符串 Object
形式。
参数
obj
- 一个Object
。结果
如果参数是
null
,那么一个字符串等于"null"
; 否则返回值obj.toString()
。另请参见:
Object.toString()
valueOf
public static String valueOf(char[] data)
返回char
数组参数的字符串char
形式。 字符数组的内容被复制; 字符数组的后续修改不会影响返回的字符串。
参数
data
- 字符数组。结果
一个
String
,其中包含字符数组的字符。valueOf
public static String valueOf(char[] data,int offset,int count)
返回char
数组参数的特定子阵列的字符串char
形式。
offset
参数是子阵列的第一个字符的索引。 count
参数指定子数组的长度。 副本的内容被复制; 字符数组的后续修改不会影响返回的字符串。
参数
data
- 字符数组。offset
- 子阵列的初始偏移量。count
- 子阵列的长度。结果
一个
String
,其中包含字符数组的指定子阵列的字符。异常
IndexOutOfBoundsException
- 如果offset
为负数,或count
为负数,或offset+count
大于data.length
。
intern
public String intern()
返回字符串对象的规范表示。
最初为空的字符串池由String
类String
。
当调用intern方法时,如果池已经包含与equals(Object)
方法确定的相当于此String
对象的字符串,则返回来自池的字符串。 否则,此String
对象将添加到池中,并返回对此String
对象的引用。
由此可见,对于任何两个字符串s
和t
, s.intern() == t.intern()
是true
当且仅当s.equals(t)
是true
。
所有文字字符串和字符串值常量表达式都被实体化。 字符串文字在The Java™ Language Specification的 3.10.5节中定义。
结果
一个字符串与该字符串具有相同的内容,但保证来自一个唯一的字符串池。
Java String类Api文档相关推荐
- Java微信支付API文档测试
Java微信支付API文档测试(注意用的微信开发文档是什么支付) 本人用的刷卡支付( 之前看错了,一直在看扫码支付,心塞 ),如图 首先,做一系列准备,获取appid等等,可以写在一个配置文件里面,如 ...
- XDoc 基于Java注释生成API文档
XDoc 基于Java注释生成API文档 <!--加入maven依赖--> <dependency><groupId>com.github.treeleafj< ...
- Java:一个API文档框架Swagger
新建SpringBoot项目,添加依赖 <!-- Swagger2 --> <dependency><groupId>io.springfox</groupI ...
- java如何生成api文档_api文档自动生成工具
java开发,根据代码自动生成api接口文档工具,支持RESTful风格,今天我们来学一下api-doc的生成 预览 在线预览地址 开发原理 这个工具是一个典型的前后端分离开发的项目,想了解前后端分离 ...
- java基础知识 API文档 字符串基本操作 正则表达式 Object
目录 JDK API 什么是JDK API JDk包结构 文档注释规范 文档注释 String及其常用API String是不可变对象 String常量池 内存编码及长度 String常用方法 Str ...
- java JDK1.8 API文档免费下载(中英文版)
JDK文档中文版和英文版 学习java怎么能缺少API帮助文档呢?经过我的不断搜寻,jdk1.8的中文版和英文版都给你们整理好了,不用谢,喜欢就关注我,我们一起学习. jdk1.8中文版 jdk1.8 ...
- Java支付宝支付API文档测试
首先登录支付宝开放平台,找到开发者中心的沙箱 创建沙箱环境,通过支付宝文档,获取支付宝公钥. 获取沙箱账号,卖家和买家,下载一个沙箱支付宝,可以进行测试 现在准备工作做好了,下面是代码测试,创建一个测 ...
- java wait api_java API 文档
DMS Java API 导入Jar包 org.eclipse.paho.client.mqttv3_1.0.2_dms.jar 初始化 String clientId = "JavaSam ...
- 安卓java百度地图api文档_Android调用百度地图API 实时定位代码
[java]代码库package yu.hong.map; import com.baidu.mapapi.BMapManager; import com.baidu.mapapi.GeoPoint; ...
最新文章
- css txt-aline,CSS规则定义.doc
- 与工作流关联的服务器发生意外错误
- html jsf ajax blur,JSF和AJAX:隐藏网站的一部分,直到第一个Ajax请求
- Windows 技术篇-利用telnet方法ping端口通不通实例演示,如何测试服务器端口是否启用,windows启用telnet功能
- 八十八、CSS两列三列的布局方式
- 如何在屏幕实时显示自己键盘的输入字符?
- 进入职场,为什么都需要了解办公软件,了解它对我们有什么作用?
- python 统计分析 包_Python 数据分析包:pandas 基础
- debian mysql目录_debian Squeeze配置apache php mysql环境,debian中apache目录结
- 网站跨域访问解决方法
- 程序员入门:三本必看的书
- 中英文网站googleSEO优化技巧
- Linux服务端监控
- mixpanel实验教程(1) 支持
- COLD:中文冒犯性语言检测数据集
- 微信小程序java python node医疗微服务系统医院预约挂号系统
- mysql(update)
- java setAttribute的使用
- VIEWGOOD(远古)供应校园网视频点播系统
- 答群友公式推导疑问:守恒和非守恒公式的动量方程推导
热门文章
- 微软原版软件下载链接集合
- python学习之路(1)
- 虚拟机配置静态IP (在VMware Workstation 16 Pro + Ubuntu 22.04.1 LTS GNOME图形桌面环境下)
- python matplotlib pyecharts绘制股市行情个股信息K线动态图表
- Photoshop CS6常用快捷键汇总
- 2021-2027全球与中国微型激光投影仪市场现状及未来发展趋势
- 如何在数控车床上修复螺纹?
- Flink SQL 性能优化
- 玉米社:外链、反链、内链、友链的区别与联系详解
- 关闭wamp警告php语句,php,_php的wamp环境搭建问题,php - phpStudy