樹(shù)結(jié)構(gòu)圖
您現(xiàn)在的位置： > 技術(shù)沙龍 > 程序設(shè)計(jì) > Java > JDK API 參考 > java.lang > 類(Class) > String
- 相關(guān)軟件
>String 創(chuàng)建者：webmaster 更新時(shí)間：2005-12-17 03:23String類表示字符串。 在 Java 程序中所有的字符串常量，如"abc"，都被實(shí)現(xiàn)為這個(gè)類的實(shí)例。字符串是常量；他們的值在生成后不能改變。字符串緩沖區(qū)支持可變的字符串。 因?yàn)樽址畬?duì)象是不可變的，所以它們可以被共享。 例如:
String str = "abc";等價(jià)于：
char data[] = {'a', 'b', 'c'}; String str = new String(data);下面是一些關(guān)于如何使用字符串的更多的示例：
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類包括檢查字符串序列中單個(gè)字符的方法，這些方法用于比較字符串、查找字符串、抽取子字符串、生成一個(gè)字符串拷貝和把所有字符都轉(zhuǎn)換為大寫(xiě)或小寫(xiě)。Java 語(yǔ)言提供對(duì)字符串連接操作符 ( + )和其它字符串對(duì)象相互轉(zhuǎn)換的特殊支持。 字符串連結(jié)是通過(guò)
StringBuffer類和它的append方法實(shí)現(xiàn)的。 字符串轉(zhuǎn)換是通過(guò)toString方法實(shí)現(xiàn)的，該方法由Object定義并且被 Java 中的所有類繼承。 關(guān)于字符串連結(jié)和轉(zhuǎn)換的其它信息 ， 參見(jiàn) Gosling 、Joy、和 Steele 的書(shū) Java 語(yǔ)言規(guī)范 。類 java.lang.String
java.lang.Object | +----java.lang.String
- public final class String
- extends Object
- implements Serializable
- extends Object
- 來(lái)自:
- JDK1.0
- 參見(jiàn):
- toString, StringBuffer, append, append, append, append, append, append, append, append, append, append
構(gòu)造子索引
- String()
- 分配一個(gè)新的不含有字符的
String。 - String(byte[])
- 用平臺(tái)的缺省字符編碼方式轉(zhuǎn)換指定的字節(jié)數(shù)組生成一個(gè)新的
String。 - String(byte[], int)
- 分配一個(gè)新的
String，它包含有從一8位整型數(shù)組構(gòu)造得到的字符。 不推薦使用該方法。 - String(byte[], int, int)
- 使用平臺(tái)的缺省字符編碼方式轉(zhuǎn)換指定的字節(jié)子數(shù)組生成一新的
String - String(byte[], int, int, int)
- 分配一新的
String，它包含有從一8位整型數(shù)組的子數(shù)組構(gòu)造得到的字符。 不推薦使用該方法。 - String(byte[], int, int, String)
- 用指定的字符編碼方式轉(zhuǎn)換指定的字節(jié)子數(shù)組生成一個(gè)新的
String。 - String(byte[], String)
- 用指定的字符編碼方式轉(zhuǎn)換指定的字節(jié)數(shù)組生成一個(gè)新的
String。 - String(char[])
- 分配一個(gè)新
String，它包含有字符數(shù)組參數(shù)中的字符序列。 - String(char[], int, int)
- 分配一個(gè)新
String，它包含有字符數(shù)組參數(shù)的一個(gè)子數(shù)組中的字符序列。 - String(String)
- 分配一個(gè)新
String，它和字符串參數(shù)中有相同的字符序列。 - String(StringBuffer)
- 分配一個(gè)新
String，它包含有當(dāng)前字符串緩沖區(qū)參數(shù)中的字符序列。
方法索引
- charAt(int)
- 返回指定索引處的字符。
- compareTo(String)
- 按詞典順序比較兩個(gè)字符串。
- concat(String)
- 將一個(gè)指定的字符串添加到該字符串尾部。
- copyValueOf(char[])
- 返回一個(gè)等價(jià)于指定字符數(shù)組的 String 。
- copyValueOf(char[], int, int)
- 返回一個(gè)等價(jià)于指定字符數(shù)組的 String 。
- endsWith(String)
- 測(cè)試該字符串尾部是否是指定的后綴。
- equals(Object)
- 比較該字符串和指定的對(duì)象。
- equalsIgnoreCase(String)
- 比較該 String 和另一個(gè)對(duì)象。
- getBytes()
- 按照平臺(tái)缺省的字符編碼方式把該
String轉(zhuǎn)換成字節(jié)，并把結(jié)果存到一新的字節(jié)數(shù)組中。 - getBytes(int, int, byte[], int)
- 從該字符串中拷貝字符到目的字節(jié)數(shù)組中。 不推薦使用該方法。
- getBytes(String)
- 按照指定的字符編碼方式把該
String轉(zhuǎn)換成字節(jié)，并把結(jié)果存到一新的字節(jié)數(shù)組中。 - getChars(int, int, char[], int)
- 從該字符串中拷貝字符到目的字符數(shù)組中。
- hashCode()
- 返回該字符串的哈希碼。
- indexOf(int)
- 返回在該字符串中指定字符第一次出現(xiàn)處的索引。
- indexOf(int, int)
- 在指定索引處開(kāi)始查找，返回在該字符串中指定字符第一次出現(xiàn)處的索引。
- indexOf(String)
- 返回在該字符串中指定的子字符串第一次出現(xiàn)處的索引。
- indexOf(String, int)
- 在指定索引處開(kāi)始查找，返回在該字符串中指定的子字符串第一次出現(xiàn)處的索引。
- intern()
- 返回該字符串對(duì)象的規(guī)范表示法。
- lastIndexOf(int)
- 返回在該字符串中指定字符最后一次出現(xiàn)處的索引。
- lastIndexOf(int, int)
- 在指定索引處開(kāi)始查找，返回在該字符串中指定字符最后一次出現(xiàn)處的索引。
- lastIndexOf(String)
- 返回在該字符串中指定子字符串在最左端出現(xiàn)處的索引。
- lastIndexOf(String, int)
- 返回在該字符串中指定子字符串最后一次出現(xiàn)處的索引。
- length()
- 返回該字符串的長(zhǎng)度。
- regionMatches(boolean, int, String, int, int)
- 測(cè)試兩個(gè)字符串區(qū)域是否相等。
- regionMatches(int, String, int, int)
- 測(cè)試兩個(gè)字符串區(qū)域是否相等。
- replace(char, char)
- 返回一個(gè)新字符串，所得結(jié)果是把該字符串中所有的
oldChar替換成newChar。 - startsWith(String)
- 測(cè)試該字符串開(kāi)頭是否是指定的前綴。
- startsWith(String, int)
- 測(cè)試該字符串開(kāi)頭是否是指定的前綴。
- substring(int)
- 返回是該字符串子串的新字符串。
- substring(int, int)
- 返回是該字符串子串的新字符串。
- toCharArray()
- 把該字符串轉(zhuǎn)換成一新的字符數(shù)組。
- toLowerCase()
- 把該
String轉(zhuǎn)換為小寫(xiě)。 - toLowerCase(Locale)
- 用給定的位置規(guī)則把該
String中的所有的字符轉(zhuǎn)換為小寫(xiě)。 - toString()
- 返回該對(duì)象 (已經(jīng)是一個(gè)字符串!) 自身。
- toUpperCase()
- 把該
String轉(zhuǎn)換為大寫(xiě)。 - toUpperCase(Locale)
- 用給定的位置規(guī)則把該
String中的所有的字符轉(zhuǎn)換為大寫(xiě)。 - trim()
- 刪除該字符串兩端的空格。
- valueOf(boolean)
- 返回
boolean參數(shù)的字符串表示。 - valueOf(char)
- 返回
char* 參數(shù)的字符串表示。 - valueOf(char[])
- 返回
char數(shù)組參數(shù)的字符串表示。 - valueOf(char[], int, int)
- 返回
char數(shù)組參數(shù)的一個(gè)指定子數(shù)組的字符串表示。 - valueOf(double)
- 返回
double參數(shù)的字符串表示。 - valueOf(float)
- 返回
float參數(shù)的字符串表示。 - valueOf(int)
- 返回
int參數(shù)的字符串表示。 - valueOf(long)
- 返回
long參數(shù)的字符串表示。 - valueOf(Object)
- 返回
Object參數(shù)的字符串表示。
構(gòu)造子
Stringpublic String()
- 分配一個(gè)新的不含有字符的
String。
public String(String value)
- 分配一個(gè)新
String，它包含有與字符串參數(shù)相同的字符序列。- 參數(shù)：
- value - 一個(gè)
String.
public String(char value[])
- 分配一個(gè)新
String，它包含有當(dāng)前字符數(shù)組參數(shù)中的字符。- 參數(shù)：
- value - 字符串的初始值
public String(char value[], int offset, int count)- 分配一個(gè)新
String，它包含字符數(shù)組參數(shù)的一個(gè)子數(shù)組的字符。offset參數(shù)是子數(shù)組中第一個(gè)字符的索引，count參數(shù)指定了子數(shù)組的長(zhǎng)度。- 參數(shù)：
- value - 源字符數(shù)組。
- offset - 初始的偏移值。
- count - 長(zhǎng)度。
- offset - 初始的偏移值。
- 拋出： StringIndexOutOfBoundsException
- 如果
offset和count參數(shù)超出了value數(shù)組的邊界。
public String(byte ascii[], int hibyte, int offset, int count)- 注意：不推薦使用 String() 方法。
該方法不適當(dāng)?shù)匕炎止?jié)轉(zhuǎn)換成字符。同 JDK 1.1 類似，完成此操作的首選方法是采用
String構(gòu)造函數(shù)，它攜帶一個(gè)字符-編碼方式名，或平臺(tái)的缺省編碼方式名作參數(shù)。- 從一個(gè)8位整型數(shù)組的子數(shù)組生成一新的
String。offset參數(shù)是子數(shù)組中第一個(gè)字節(jié)處的索引，count參數(shù)指定了子數(shù)組的長(zhǎng)度。子數(shù)組中的每個(gè)
byte如上面方法描述的那樣被轉(zhuǎn)換為一個(gè)char。 - 從一個(gè)8位整型數(shù)組的子數(shù)組生成一新的
public String(byte ascii[], int hibyte)- 注意：不推薦使用 String() 方法。
該方法不適當(dāng)?shù)匕炎止?jié)轉(zhuǎn)換成字符。同 JDK 1.1 類似，完成此操作的首選方法是采用
String構(gòu)造函數(shù)，它攜帶一個(gè)字符-編碼方式名，或平臺(tái)的缺省編碼名作參數(shù)。- 從一個(gè) 8-bit 整型數(shù)組生成一新的
String。 結(jié)果字符串中的每個(gè)字符 c 是由字節(jié)數(shù)組中的對(duì)應(yīng)部分 b 構(gòu)造的。如：c == (char)(((hibyte & 0xff) << 8) | (b & 0xff)) - 從一個(gè) 8-bit 整型數(shù)組生成一新的
public String(byte bytes[], int offset, int length, String enc) throws UnsupportedEncodingException- 用指定的字符編碼方式轉(zhuǎn)換指定的字節(jié)子數(shù)組生成一個(gè)新的
String。 新String的長(zhǎng)度是一個(gè)編碼函數(shù)，因此可能不等于子數(shù)組的長(zhǎng)度。- 參數(shù)：
- bytes - 要轉(zhuǎn)換為字符的字節(jié)。
- offset - 要轉(zhuǎn)換的第一個(gè)字節(jié)的索引。
- length - 要轉(zhuǎn)換的字節(jié)數(shù)。
- enc - 字符編碼方式的名稱。
- offset - 要轉(zhuǎn)換的第一個(gè)字節(jié)的索引。
- 拋出： UnsupportedEncodingException
- 如果不支持該編碼方式
public String(byte bytes[], String enc) throws UnsupportedEncodingException- 用指定的字符編碼方式轉(zhuǎn)換指定的字節(jié)數(shù)組生成一新的
String。 新String的長(zhǎng)度是一個(gè)編碼函數(shù)，因此可能不等于字節(jié)數(shù)組的長(zhǎng)度。- 參數(shù)：
- bytes - 要轉(zhuǎn)換為字符的字節(jié)。
- enc - 一個(gè)字符-編碼方式名
- 拋出： UnsupportedEncodingException
- 如果不支持該編碼方式
public String(byte bytes[], int offset, int length)- 用平臺(tái)缺省的字符編碼方式轉(zhuǎn)換指定的字節(jié)子數(shù)組生成一個(gè)新的
String。 新String的長(zhǎng)度是一個(gè)編碼函數(shù)，因此可能不等于子數(shù)組的長(zhǎng)度。- 參數(shù)：
- bytes - 要轉(zhuǎn)換為字符的字節(jié)。
- offset - 要轉(zhuǎn)換的第一個(gè)字節(jié)的索引。
- length - 要轉(zhuǎn)換的字節(jié)數(shù)。
- offset - 要轉(zhuǎn)換的第一個(gè)字節(jié)的索引。
public String(byte bytes[])
- 用平臺(tái)缺省的字符編碼方式轉(zhuǎn)換指定的字節(jié)數(shù)組生成一新的
String。 新String的長(zhǎng)度是一個(gè)編碼函數(shù)，因此可能不等于字節(jié)數(shù)組的長(zhǎng)度。- 參數(shù)：
- bytes - 要轉(zhuǎn)換為字符的字節(jié)。
public String(StringBuffer buffer)
- 分配一個(gè)新
String，它包含有當(dāng)前字符串緩沖區(qū)參數(shù)中的字符序列。- 參數(shù)：
- buffer - 一個(gè)
StringBuffer.
方法
lengthpublic int length()
- 返回該字符串的長(zhǎng)度。
長(zhǎng)度等于字符串中的 16-bit 的
Unicode 字符的數(shù)量。
- 返回:
- 該對(duì)象代表的字符序列的長(zhǎng)度。
public char charAt(int index)
- 返回指定索引處的字符。 索引范圍
從
0到length() - 1。- 參數(shù)：
- index - 字符的索引。
- 返回:
- 該字符串指定位置的字符。
第一個(gè)字符在索引
0處。 - 拋出： StringIndexOutOfBoundsException
- 如果索引超出了范圍。
public void getChars(int srcBegin, int srcEnd, char dst[], int dstBegin)- 從該字符串中拷貝字符到目的字符數(shù)組中。
第一個(gè)要復(fù)制的字符在索引
srcBegin處； 最后一個(gè)要復(fù)制的字符在索引srcEnd-1處(因此要復(fù)制的字符總數(shù)就是srcEnd-srcBegin) 。要復(fù)制到dst子數(shù)組的字符開(kāi)始于索引dstBegin，結(jié)束于索引：dstbegin + (srcEnd-srcBegin) - 1- 參數(shù)：
- srcBegin - 要復(fù)制的字符串中第一個(gè)字符的索引。
- srcEnd - 要復(fù)制的字符串中最后一個(gè)字符的索引。
- dst - 目標(biāo)數(shù)組。
- dstBegin - 目標(biāo)數(shù)組中的開(kāi)始偏移量。
- srcEnd - 要復(fù)制的字符串中最后一個(gè)字符的索引。
- 拋出： StringIndexOutOfBoundsException
- 如果 srcBegin 或 srcEnd 超出了范圍，或如果 srcBegin 大于 srcEnd 。
public void getBytes(int srcBegin, int srcEnd, byte dst[], int dstBegin)- 注意：不推薦使用 getBytes() 方法。
該方法不適當(dāng)?shù)匕炎址D(zhuǎn)換成字節(jié)。同 JDK 1.1 類似，完成此操作的首選方法是采用
getBytes(String enc)方法， 它使用一個(gè)字符-編碼方式名作參數(shù)，或使用getBytes()方法，它使用平臺(tái)的缺省編碼方式。- 從該字符串拷貝字符到目的字節(jié)數(shù)組中。 每個(gè)字節(jié)接收對(duì)應(yīng)字符的低8位。
第一個(gè)要復(fù)制的字符在索引
srcBegin處； 最后一個(gè)要復(fù)制的字符在索引srcEnd-1處。要復(fù)制的字符總數(shù)是srcEnd-srcBegin。字符被轉(zhuǎn)換成字節(jié)復(fù)制到dst子數(shù)組。它開(kāi)始于索引dstBegin，結(jié)束于索引：dstbegin + (srcEnd-srcBegin) - 1- 參數(shù)：
- srcBegin - 要復(fù)制的字符串中第一個(gè)字符的索引。
- srcEnd - 要復(fù)制的字符串中最后一個(gè)字符的索引。
- dst - 目標(biāo)數(shù)組。
- dstBegin - 目標(biāo)數(shù)組中的開(kāi)始偏移量。
- srcEnd - 要復(fù)制的字符串中最后一個(gè)字符的索引。
- 拋出： StringIndexOutOfBoundsException
- 如果 srcBegin 或 srcEnd 超出了范圍，或如果 srcBegin 大于 srcEnd 。
- 從該字符串拷貝字符到目的字節(jié)數(shù)組中。 每個(gè)字節(jié)接收對(duì)應(yīng)字符的低8位。
public byte[] getBytes(String enc) throws UnsupportedEncodingException
- 按照指定的字符編碼方式把該
String轉(zhuǎn)換為字節(jié)，結(jié)果存到一個(gè)新的字節(jié)數(shù)組中。- 參數(shù)：
- enc - 一個(gè)字符-編碼名稱
- 返回:
- 結(jié)果的字節(jié)數(shù)組
- 拋出： UnsupportedEncodingException
- 如果不支持該編碼方式
public byte[] getBytes()
- 按照平臺(tái)缺省的字符編碼方式把該
String轉(zhuǎn)換成字節(jié)，并把結(jié)果存到一新的字節(jié)數(shù)組中。- 返回:
- 作為結(jié)果的字節(jié)數(shù)組
public boolean equals(Object anObject)
- 比較該字符串和指定的對(duì)象。當(dāng)且僅當(dāng)參數(shù)不為
null，且是一個(gè)String對(duì)象，它表示的字符序列與此對(duì)象相同時(shí)結(jié)果為true。- 參數(shù)：
- anObject - 要同該
String作比較的對(duì)象。 - 返回:
- 如果和
String相等則為true；否則為false。 - 覆蓋:
- 類 Object 中的 equals
- 參見(jiàn):
- compareTo, equalsIgnoreCase
public boolean equalsIgnoreCase(String anotherString)
- 比較該字符串和另一個(gè)對(duì)象。
當(dāng)且僅當(dāng)參數(shù)不為
null，且是一個(gè)String對(duì)象，它所表示的字符序列在大小寫(xiě)被忽略時(shí)與此對(duì)象相同，則結(jié)果為true。如果至少滿足以下條件之一，則兩個(gè)字符在忽略大小寫(xiě)時(shí)被認(rèn)為是相等的：
- 兩個(gè)字符是相同的 (通過(guò)
==運(yùn)算符比較)。 - 對(duì)每個(gè)字符應(yīng)用方法
Character.toUppercase，產(chǎn)生的結(jié)果相同。 - 對(duì)每個(gè)字符應(yīng)用方法
Character.toLowercase，產(chǎn)生的結(jié)果相同。
如果兩個(gè)字符序列有相同的長(zhǎng)度且對(duì)應(yīng)的字符在忽略大小寫(xiě)時(shí)相同，，則兩個(gè)字符序列被認(rèn)為是相等的。
- 參數(shù)：
- anotherString - 要同該
String相比較的String。 - 返回:
- 忽略大小寫(xiě)時(shí)，如果和
String相等，則為true；否則為false。 - 參見(jiàn)：
- toLowerCase, toUpperCase
- 兩個(gè)字符是相同的 (通過(guò)
public int compareTo(String anotherString)
- 按詞典順序比較兩個(gè)字符串。
比較的基礎(chǔ)是字符串中每個(gè)字符的 Unicode 值。
- 參數(shù)：
- anotherString - 要比較的
String。 - 返回:
- 若參數(shù)字符串等于該字符串，則返回
0；若該字符串按詞典順序小于參數(shù)字符串則返回值小于0；若該字符串按詞典順序大于參數(shù)字符串則返回值大于0。
public boolean regionMatches(int toffset, String other, int ooffset, int len)- 測(cè)試兩個(gè)字符串區(qū)域是否相等。
如果
toffset或ooffset是負(fù)的，或如果toffset+length大于該字符串的長(zhǎng)度， 或ooffset+length大于參數(shù)字符串的長(zhǎng)度，那么該方法返回false。- 參數(shù)：
- toffset - 該字符串中子區(qū)域的開(kāi)始偏移量。
- other - 字符串參數(shù)。
- ooffset - 參數(shù)字符串中子區(qū)域的開(kāi)始偏移量。
- len - 要比較的字符數(shù)。
- other - 字符串參數(shù)。
- 返回:
- 若該字符串的指定子區(qū)域精確匹配參數(shù)字符串中的指定子區(qū)域則返回
true，否則返回false。
public boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)- 測(cè)試兩個(gè)字符串區(qū)域是否相等。
如果
toffset或ooffset是負(fù)的，或如果toffset+length大于該字符串的長(zhǎng)度， 或ooffset+length大于參數(shù)字符串的長(zhǎng)度，那么該方法返回false。- 參數(shù)：
- ignoreCase - 如果為
true，則比較時(shí)忽略大小寫(xiě)。- toffset - 該字符串中子區(qū)域的開(kāi)始偏移量。
- other - 字符串參數(shù)。
- ooffset - 參數(shù)字符串中子區(qū)域的開(kāi)始偏移量。
- len - 要比較的字符數(shù)。
- toffset - 該字符串中子區(qū)域的開(kāi)始偏移量。
- 返回:
- 若該字符串的指定子區(qū)域匹配參數(shù)字符串中的指定子區(qū)域則返回
true，否則返回false。 匹配是否精確或是否大小寫(xiě)敏感依賴于ignoreCase參數(shù)。
public boolean startsWith(String prefix, int toffset)
- 測(cè)試該字符串是否是以指定的前綴開(kāi)頭。
- 參數(shù)：
- prefix - 前綴。
- toffset - 在字符串中查找的起始點(diǎn)。
- 返回:
- 若參數(shù)表示的字符序列是該對(duì)象開(kāi)始于索引
toffset處的子字符串前綴則返回true，否則返回false。
public boolean startsWith(String prefix)
- 測(cè)試該字符串是否以指定的前綴開(kāi)始。
- 參數(shù)：
- prefix - 前綴。
- 返回:
- 若參數(shù)表示的字符序列是該字符串序列的前綴則返回
true，否則返回false。
public boolean endsWith(String suffix)
- 測(cè)試該字符串是否以指定的字符串作后綴。
- 參數(shù)：
- suffix - 后綴。
- 返回:
- 若參數(shù)表示的字符序列是該對(duì)象字符序列的后綴則返回
true，否則返回false。
public int hashCode()
- 返回該字符串的哈希碼。
- 返回:
- 該對(duì)象的哈希碼值。
- 覆蓋:
- 類 Object 中的 hashCode
public int indexOf(int ch)
- 返回在該字符串中指定字符第一次出現(xiàn)處的索引。
- 參數(shù)：
- ch - 一個(gè)字符。
- 返回:
- 對(duì)象表示的字符序列中該字符第一次出現(xiàn)處的索引，若字符沒(méi)有出現(xiàn)則返回
-1。
public int indexOf(int ch, int fromIndex)- 從指定的索引開(kāi)始查找，返回在該字符串中指定字符第一次出現(xiàn)處的索引。
- 參數(shù)：
- ch - 一個(gè)字符。
- fromIndex - 開(kāi)始查找位置的索引。
- 返回:
- 在該對(duì)象表示的字符序列中大于或等于
fromIndex字符的字符第一次出現(xiàn)處的索引，若字符沒(méi)有出現(xiàn)則返回-1。
public int lastIndexOf(int ch)
- 返回指定字符在該字符串中最后一次出現(xiàn)處的索引。查找順序是從最后一個(gè)字符開(kāi)始回退查找。
- 參數(shù)：
- ch - 一個(gè)字符。
- 返回:
- 對(duì)象表示的字符序列中該字符最后一次出現(xiàn)處的索引，若字符沒(méi)有出現(xiàn)則返回
-1。
public int lastIndexOf(int ch, int fromIndex)- 返回指定字符在該字符串中最后一次出現(xiàn)處的索引，在指定索引處開(kāi)始進(jìn)行反向查找。
- 參數(shù)：
- ch - 一個(gè)字符。
- fromIndex - 開(kāi)始查找位置的索引。
- 返回:
- 該對(duì)象表示的字符序列中小于或等于
fromIndex字符的字符最后一次出現(xiàn)處的下標(biāo)，若字符在該位置之前沒(méi)有出現(xiàn)過(guò)則返回-1。
public int indexOf(String str)
- 返回指定子字符串在該字符串中第一次出現(xiàn)處的索引。
- 參數(shù)：
- str - 子字符串。
- 返回:
- 若字符串參數(shù)作為該對(duì)象的子串出現(xiàn)，則返回第一個(gè)這樣的子串第一個(gè)字符的索引，如果它沒(méi)有作為一個(gè)子串出現(xiàn)則返回
-1。
public int indexOf(String str, int fromIndex)
- 從指定索引位置處開(kāi)始查找，返回指定子字符串在該字符串中第一次出現(xiàn)處的索引。
- 參數(shù)：
- str - 要搜索的子串。
- fromIndex - 開(kāi)始查找位置的索引。
- 返回:
- 如果字符串參數(shù)作為該對(duì)象起始位置不小于
fromIndex的子串出現(xiàn)時(shí)，則返回第一個(gè)這樣的子串首字符的索引。 若它沒(méi)有作為從fromIndex開(kāi)始或靠后位置開(kāi)始的子串出現(xiàn)，則返回-1。
public int lastIndexOf(String str)
- 返回指定子字符串在該字符串中最右端出現(xiàn)處的索引。最右端的空字符串 "" 被認(rèn)為出現(xiàn)在下標(biāo)值為
this.length()位置。- 參數(shù)：
- str - 要搜索的子串。
- 返回:
- 如果字符串參數(shù)作為該對(duì)象的一個(gè)子串出現(xiàn)了一次或更多次，則返回最后一個(gè)這樣的子串第一個(gè)字符的索引。若沒(méi)有作為一個(gè)子串出現(xiàn)則返回
-1。
public int lastIndexOf(String str, int fromIndex)
- 返回在指定子字符串在該字符串中最后一次出現(xiàn)處的索引。返回的索引指示了子串的開(kāi)始位置，并且它必須等于或小于
fromIndex。- 參數(shù)：
- str - 要搜索的子串。
- fromIndex - 開(kāi)始查找位置的索引。
- 返回:
- 若字符串參數(shù)作為該對(duì)象起始索引不大于
fromIndex的子串出現(xiàn)了一次或多次，則返回最后一個(gè)這樣的子串第一個(gè)字符的索引。若它沒(méi)有作為從fromIndex開(kāi)始或靠前位置開(kāi)始的子串出現(xiàn)，則返回-1。
public String substring(int beginIndex)
- 返回是該字符串子串的新字符串。子串開(kāi)始于指定的位置并且擴(kuò)展到該字符串結(jié)尾。
- 參數(shù)：
- beginIndex - 開(kāi)始位置索引(包括它本身在內(nèi))。
- 返回:
- 指定的子串。
- 拋出： StringIndexOutOfBoundsException
- 如果
beginIndex超出了范圍。
public String substring(int beginIndex, int endIndex)
- 返回是該字符串子串的新字符串。 子串開(kāi)始于指定的
beginIndex，且擴(kuò)展到索引為endIndex - 1的位置。- 參數(shù)：
- beginIndex - 開(kāi)始索引(包括它本身在內(nèi))。
- ]endIndex - 終止索引(不包括本身)。
- 返回:
- 指定的子串。
- 拋出： StringIndexOutOfBoundsException
- 如果
beginIndex或endIndex超出了范圍。
public String concat(String str)
- 將一個(gè)指定的字符串添加到該字符串尾部。
如果參數(shù)長(zhǎng)度是
0，則返回該對(duì)象。- 參數(shù)：
- str - 要連接到該
String尾部的String。 - 返回:
- 一個(gè)表示兩字符串連接結(jié)果的字符串 。
public String replace(char oldChar, char newChar)
- 返回一個(gè)新字符串，所得結(jié)果是把該字符串中所有的
oldChar替換成newChar。如果字符
oldChar沒(méi)有出現(xiàn)在該對(duì)象表示的字符串序列中，則返回該字符串。- 參數(shù)：
- oldChar - 舊字符。
- newChar - 新字符。
- 返回:
- 一個(gè)字符串，由該字符串中出現(xiàn)的每個(gè)
oldChar被替換為newChar得到。
public String toLowerCase(Locale locale)
- 用給定的位置規(guī)則把該
String中所有的字符轉(zhuǎn)換為小寫(xiě)。- 參數(shù)：
- locale - 對(duì)該位置做大小寫(xiě)變換
- 返回:
- 被轉(zhuǎn)換成小寫(xiě)的字符串。
- 參見(jiàn):
- toLowerCase, toUpperCase
public String toLowerCase()
- 轉(zhuǎn)換該
String為小寫(xiě)。按照
Character定義的toLowerCase方法，如果字符串中沒(méi)有應(yīng)該被轉(zhuǎn)換的字符，則返回原始字符串。否則，將分配一個(gè)新字符串，它的長(zhǎng)度等于該字符串，并且源字符串中每個(gè)該進(jìn)行小寫(xiě)轉(zhuǎn)換的字符都被轉(zhuǎn)換成等價(jià)的小寫(xiě)字符。
- 返回:
- 被轉(zhuǎn)換成小寫(xiě)的字符串。
- 參見(jiàn):
- toLowerCase, toUpperCase
public String toUpperCase(Locale locale)
- 用給定的位置規(guī)則把該
String中的所有字符轉(zhuǎn)換為大寫(xiě)。- 參數(shù)：
- locale - 對(duì)該位置做大小寫(xiě)變換
- 返回:
- 被轉(zhuǎn)換成大寫(xiě)的字符串。
- 參見(jiàn):
- toUpperCase, toLowerCase
public String toUpperCase()
- 轉(zhuǎn)換該
String為大寫(xiě)。按照
Character定義的toUpperCase方法，如果在字符串中沒(méi)有應(yīng)該進(jìn)行大寫(xiě)轉(zhuǎn)換的字符，則返回原始字符串。否則，將分配一個(gè)新字符串，它的長(zhǎng)度等于該字符串，并且源字符串中每個(gè)應(yīng)該大寫(xiě)轉(zhuǎn)換的字符都被轉(zhuǎn)換成等價(jià)的大寫(xiě)字符。
- 返回:
- 被轉(zhuǎn)換成大寫(xiě)的字符串。
- 參見(jiàn):
- toUpperCase, toLowerCase
public String trim()
- 刪除該字符串兩端的空格。
所有小于或等于
'\u0020'(空格字符)的字符都被認(rèn)為是空格。- 返回:
- 頭尾兩端的空格都被刪掉的字符串。
public String toString()
- 該對(duì)象(已經(jīng)是一個(gè)字符串!)本身被返回。
- 返回:
- 字符串本身。
- 覆蓋:
- 類 Object 中的 toString
public char[] toCharArray()
- 把該字符串轉(zhuǎn)換成一個(gè)新的字符數(shù)組。
- 返回:
- 一個(gè)新分配的字符數(shù)組，其長(zhǎng)度就是該字符串的長(zhǎng)度，內(nèi)容初始化為該字符串表示的字符序列。
public static String valueOf(Object obj)
- 返回
Object參數(shù)的字符串表示。- 參數(shù)：
- obj - 一個(gè)
Object. - 返回:
- 如果參數(shù)是
null，則返回一個(gè)等于"null"的字符串；否則返回obj.toString()。 - 參見(jiàn):
- toString
public static String valueOf(char data[])
- 返回
char數(shù)組參數(shù)的字符串表示。- 參數(shù)：
- data - 一個(gè)
char數(shù)組。 - 返回:
- 一個(gè)新分配的字符串，表示包含在字符數(shù)組參數(shù)中的相同字符序列。
public static String valueOf(char data[], int offset, int count)
- 返回代表
char數(shù)組參數(shù)一個(gè)指定子數(shù)組的字符串。offset參數(shù)是子數(shù)組中第一個(gè)字符的索引。count參數(shù)指定了子數(shù)組的長(zhǎng)度。- 參數(shù)：
- data - 字符數(shù)組。
- offset -
String的起始偏移量。- count -
String字符序列的長(zhǎng)度。 - offset -
- 返回:
- 一個(gè)新分配的字符串，表示包含在字符數(shù)組參數(shù)子數(shù)組中的相同字符序列。
public static String copyValueOf(char data[], int offset, int count)
- 返回一個(gè)等價(jià)于指定字符數(shù)組的 String 。 它生成一個(gè)新數(shù)組并且向它內(nèi)部復(fù)制字符。
- 參數(shù)：
- data - 字符數(shù)組。
- offset - 子數(shù)組的起始偏移量。
- count - 子數(shù)組的長(zhǎng)度。
- offset - 子數(shù)組的起始偏移量。
- 返回:
- 一個(gè)
String，包含了字符數(shù)組指定子數(shù)組中的字符。
public static String copyValueOf(char data[])
- 返回一個(gè)等價(jià)于指定字符數(shù)組的 String 。
它生成一個(gè)新數(shù)組并且向它內(nèi)部復(fù)制字符。
- 參數(shù)：
- data - 字符數(shù)組。
- 返回:
- 一個(gè)
String，包含了字符數(shù)組中的字符。
public static String valueOf(boolean b)
- 返回
boolean參數(shù)的字符串表示。- 參數(shù)：
- b - 一個(gè)
boolean數(shù)。 - 返回:
- 如果參數(shù)是
true，返回一個(gè)等于"true"的字符串；否則返回一個(gè)等于"false"的字符串。
public static String valueOf(char c)
- 返回
char* 參數(shù)的字符串表示。- 參數(shù)：
- c - 一個(gè)
char型量。 - 返回:
- 一個(gè)長(zhǎng)度為
1的新字符串，它僅有的字符是參數(shù)c。
public static String valueOf(int i)
- 返回
int參數(shù)的字符串表示。返回內(nèi)容和參數(shù)的
Integer.toString方法返回的值相同。- 參數(shù)：
- i - 一個(gè)
int量。 - 返回:
- 一個(gè)新分配的字符串，包含了
int參數(shù)的字符串表示。 - 參見(jiàn):
- toString
public static String valueOf(long l)
- 返回代表
long參數(shù)的字符串。返回內(nèi)容和參數(shù)的
Long.toString方法返回的值相同。- 參數(shù)：
- l - 一個(gè)
long型量。 - 返回:
- 一個(gè)新分配的字符串，包含了
long參數(shù)的字符串表示。 - 參見(jiàn):
- toString
public static String valueOf(float f)
- 返回
float參數(shù)的字符串表示。返回的內(nèi)容和參數(shù)的
Float.toString方法返回的值相同。- 參數(shù)：
- f - 一個(gè)
float型量。 - 返回:
- 一個(gè)新分配的字符串，包含了
float參數(shù)的字符串表示。 - 參見(jiàn):
- toString
public static String valueOf(double d)
- 返回
double參數(shù)的字符串表示。返回的內(nèi)容和參數(shù)的
Double.toString方法返回的值相同。- 參數(shù)：
- d - 一個(gè)
double型量。 - 返回:
- 一個(gè)新分配的字符串，包含了
double參數(shù)的字符串表示。 - 參見(jiàn):
- toString
public native String intern()
- 返回一個(gè)字符串對(duì)象的規(guī)范表示法。
如果
s和t是s.equals(t)類型的字符串，那就保證了
s.intern() == t.intern().- 返回:
- 一個(gè)同該字符串內(nèi)容相同的字符串，但是來(lái)自于唯一字符串的緩沖池。
- 前一則: Character
- 后一則: StringBuffer
- public final class String