java.lang.String 類的所有方法


方法摘要 
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) 
          當且僅當此 String 表示與指定序列相同的 char 值時,才返回 true。 
boolean contentEquals(StringBuffer sb) 
          當且僅當此 String 表示與指定的 StringBuffer 相同的字符序列時,才返回 true。 
static String copyValueOf(char[] data) 
          返回指定數組中表示該字符序列的字符串。 
static String copyValueOf(char[] data, int offset, int count) 
          返回指定數組中表示該字符序列的字符串。 
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 解碼為字節序列,並將結果存儲到一個新的字節數組中。 
void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin) 
          已過時。 該方法無法將字符正確轉換為字節。從 JDK 1.1 起,完成該轉換的首選方法是通過 getBytes() 構造方法,該方法使用平台的默認字符集。 
byte[] getBytes(String charsetName) 
          使用指定的字符集將此 String 解碼為字節序列,並將結果存儲到一個新的字節數組中。 
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() 
          返回字符串對象的規范化表示形式。 
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 

--------------------------------------------------------------------------------

charAt
public char charAt(int index)返回指定索引處的 char 值。索引范圍為從 0 到 length() - 1。序列的第一個 char 值在索引 0 處,第二個在索引 1 處,依此類推,這類似於數組索引。 
如果索引指定的 char 值是代理項,則返回代理項值。 


指定者:
接口 CharSequence 中的 charAt
參數:
index - char 值的索引。 
返回:
此字符串指定索引處的 char 值。第一個 char 值在索引 0 處。 
拋出: 
IndexOutOfBoundsException - 如果 index 參數為負或小於此字符串的長度。

--------------------------------------------------------------------------------

codePointAt
public int codePointAt(int index)返回指定索引處的字符(Unicode 代碼點)。該索引引用 char 值(Unicode 代碼單元),其范圍從 0 到 length() - 1。 
如果給定索引指定的 char 值屬於高代理項范圍,則后續索引小於此 String 的長度。同樣,如果后續索引處的 char 值屬於低代理項范圍,則返回該代理項對相應的增補代碼點。否則,返回給定索引處的 char 值。 


參數:
index - char 值的索引 
返回:
該 index 處字符的代碼點值 
拋出: 
IndexOutOfBoundsException - 如果 index 參數為負或小於此字符串的長度。
從以下版本開始: 
1.5 

--------------------------------------------------------------------------------

codePointBefore
public int codePointBefore(int index)返回指定索引之前的字符(Unicode 代碼點)。該索引引用 char 值(Unicode 代碼單元),其范圍從 1 到 length。 
如果 (index - 1) 處的 char 值屬於低代理項范圍,則 (index - 2) 為非負;如果(index - 2) 處的 char 值屬於高低理項范圍,則返回該代理項對的增補代碼點值。如果 index - 1 處的 char 值是未配對的低(高)代理項,則返回代理項值。 


參數:
index - 應返回的代碼點后面的索引 
返回:
在給定索引前的 Unicode 代碼點。 
拋出: 
IndexOutOfBoundsException - 如果 index 參數小於 1 或大於此字符串的長度。
從以下版本開始: 
1.5 

--------------------------------------------------------------------------------

codePointCount
public int codePointCount(int beginIndex,
                          int endIndex)返回此 String 的指定文本范圍中的 Unicode 代碼點數。文本范圍始於指定的 beginIndex,一直到索引 endIndex - 1 處的 char。因此,該文本范圍的長度(在 char 中)是 endIndex-beginIndex。該文本范圍內未配對的代理項作為一個代碼點計數。 

參數:
beginIndex - 該文本范圍的第一個 char 的索引。
endIndex - 該文本范圍的最后一個 char 后面的索引。 
返回:
指定文本范圍中 Unicode 代碼點的數量 
拋出: 
IndexOutOfBoundsException - 如果 beginIndex 為負,或 endIndex 大於此 String 的長度,或 beginIndex 大於 endIndex。
從以下版本開始: 
1.5 

--------------------------------------------------------------------------------

offsetByCodePoints
public int offsetByCodePoints(int index,
                              int codePointOffset)返回此 String 中從給定的 index 處偏移 codePointOffset 個代碼點的索引。文本范圍內由 index 和 codePointOffset 給定的未配對代理項各計為一個代碼點。 

參數:
index - 要偏移的索引
codePointOffset - 代碼點中的偏移量 
返回:
String 的索引 
拋出: 
IndexOutOfBoundsException - 如果 index 為負或大於此 String 的長度;或者如果 codePointOffset 為正,並且以 index 開頭的子字符串比 codePointOffset 具有更少的代碼點;或者如果 codePointOffset 為負,並且 index 前的子字符串比 codePointOffset 的絕對值具有更少的代碼點。
從以下版本開始: 
1.5 

--------------------------------------------------------------------------------

getChars
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

--------------------------------------------------------------------------------

getBytes
@Deprecated
public void getBytes(int srcBegin,
                                int srcEnd,
                                byte[] dst,
                                int dstBegin)已過時。 該方法無法將字符正確轉換為字節。從 JDK 1.1 起,完成該轉換的首選方法是通過 getBytes() 構造方法,該方法使用平台的默認字符集。 

將字符從此字符串復制到目標字節數組中。每個字節接收相應字符的 8 個低位。不復制每個字符的高位,它們也不參與任何方式的轉換。 
要復制的第一個字符在索引 srcBegin 處;要復制的最后一個字符在索引 srcEnd-1 處。要復制的字符總數為 srcEnd-srcBegin。將要轉換為字節的字符復制到 dst 的子數組中,從索引 dstBegin 處開始,並結束於索引: 


     dstbegin + (srcEnd-srcBegin) - 1

參數:
srcBegin - 字符串中要復制的第一個字符的索引。
srcEnd - 字符串中要復制的最后一個字符之后的索引。
dst - 目標數組。
dstBegin - 目標數組中的起始偏移量。 
拋出: 
IndexOutOfBoundsException - 如果下列任何一項為 true: 
srcBegin 為負 
srcBegin 大於 srcEnd 
srcEnd 大於此 String 的長度 
dstBegin 為負 
dstBegin+(srcEnd-srcBegin) 大於 dst.length

--------------------------------------------------------------------------------

getBytes
public byte[] getBytes(String charsetName)
                throws java.io.UnsupportedEncodingException使用指定的字符集將此 String 解碼為字節序列,並將結果存儲到一個新的字節數組中。 
當此字符串不能在給定的字符集中解碼時,該方法無指定的行為。當需要進一步控制解碼過程時,應使用 CharsetEncoder 類。 


參數:
charsetName - 受支持的 charset 名稱 
返回:
結果字節數組 
拋出: 
java.io.UnsupportedEncodingException - 如果指定的字符集不受支持
從以下版本開始: 
JDK1.1 

--------------------------------------------------------------------------------

getBytes
public byte[] getBytes()使用平台默認的字符集將此 String 解碼為字節序列,並將結果存儲到一個新的字節數組中。 
當此字符串不能在默認的字符集中解碼時,該方法無指定的行為。當需要進一步控制解碼過程時,應使用 CharsetEncoder 類。 


返回:
結果字節數組
從以下版本開始: 
JDK1.1 

--------------------------------------------------------------------------------

equals
public boolean equals(Object anObject)比較此字符串與指定的對象。當且僅當該參數不為 null,並且是表示與此對象相同的字符序列的 String 對象時,結果才為 true。 

覆蓋:
類 Object 中的 equals
參數:
anObject - 與此 String 進行比較的對象。 
返回:
如果 String 相等,則返回 true;否則返回 false。
另請參見:
compareTo(java.lang.String), equalsIgnoreCase(java.lang.String)

--------------------------------------------------------------------------------

contentEquals
public boolean contentEquals(StringBuffer sb)當且僅當此 String 表示與指定的 StringBuffer 相同的字符序列時,才返回 true。 

參數:
sb - 要比較的 StringBuffer。 
返回:
當且僅當此 String 表示與指定的 StringBuffer 相同的字符序列時,才返回 true;否則返回 false。 
拋出: 
NullPointerException - 如果 sb 為 null
從以下版本開始: 
1.4 

--------------------------------------------------------------------------------

contentEquals
public boolean contentEquals(CharSequence cs)當且僅當此 String 表示與指定序列相同的 char 值時,才返回 true。 

參數:
cs - 要比較的序列。 
返回:
當且僅當此 String 表示與指定序列相同的 char 值的序列時;才返回 true,否則返回 false。 
拋出: 
NullPointerException - 如果 cs 為 null
從以下版本開始: 
1.5 

--------------------------------------------------------------------------------

equalsIgnoreCase
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), Character.toLowerCase(char), Character.toUpperCase(char)

--------------------------------------------------------------------------------

compareTo
public int compareTo(String anotherString)按字典順序比較兩個字符串。該比較基於字符串中各個字符的 Unicode 值。將此 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 的值。

--------------------------------------------------------------------------------

compareToIgnoreCase
public int compareToIgnoreCase(String str)不考慮大小寫,按字典順序比較兩個字符串。此方法返回一個整數,它的正負號是調用 compareTo 的正負號,調用時使用了字符串的規范化版本,其大小寫差異已通過對每個字符調用 Character.toLowerCase(Character.toUpperCase(character)) 得以消除。 
注意,此方法不 考慮語言環境,因此可能在某些特定的語言環境中產生不理想的排序。java.text 包提供 Collators 來完成語言環境敏感的排序。 


參數:
str - 要比較的 String。 
返回:
一個負整數、零或正整數,視指定的 String 大於、等於還是小於該 String 而定,不考慮大小寫。
從以下版本開始: 
1.2 
另請參見:
Collator.compare(String, String)

--------------------------------------------------------------------------------

regionMatches
public boolean regionMatches(int toffset,
                             String other,
                             int ooffset,
                             int len)測試兩個字符串區域是否相等。 
該 String 對象的一個子字符串與參數 other 的一個子字符串進行比較。如果這兩個子字符串表示相同的字符序列,則結果為 true。要比較的 String 對象的子字符串從索引 toffset 處開始,長度為 len。要比較的 other 的子字符串從索引 ooffset 處開始,長度為 len。當且僅當下列至少一項為 true 時,結果才為 false : 

toffset 為負。 
ooffset 為負。 
toffset+len 大於此 String 對象的長度。 
ooffset+len 大於另一個參數的長度。 
存在某個小於 len 的非負整數 k,它滿足:this.charAt(toffset+k) != other.charAt(ooffset+k) 

參數:
toffset - 字符串中子區域的起始偏移量。
other - 字符串參數。
ooffset - 字符串參數中子區域的起始偏移量。
len - 要比較的字符數。 
返回:
如果字符串的指定子區域完全匹配字符串參數的指定子區域,則返回 true;否則返回 false。

--------------------------------------------------------------------------------

regionMatches
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: 

toffset 為負。 
ooffset 為負。 
toffset+len 大於此 String 對象的長度。 
ooffset+len 大於另一個參數的長度。 
ignoreCase 為 false,且存在某個小於 len 的非負整數 k,即: 
this.charAt(toffset+k) != other.charAt(ooffset+k)
ignoreCase 為 true,且存在某個小於 len 的非負整數 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 參數。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM