Java核心技術卷I基礎知識3.6.7 String API

<b>3.6.7　string api</b>

java中的string類包含了50多個方法。令人驚訝的是絕大多數都很有用，可以設想使用的頻繁非常高。下面的api注釋彙總了一部分最常用的方法。

      注釋：可以發現，本書中給出的api注釋會有助于了解java應用程式程式設計接口（api）。每一個api的注釋都以形如java.lang.string的類名開始。（java.lang包的重要性将在第4章給出解釋。）類名之後是一個或多個方法的名字、解釋和參數描述。

在這裡，一般不列出某個類的所有方法，而是選擇一些最常用的方法，并以簡潔的方式給予描述。完整的方法清單請參看聯機文檔（請參看3.6.8節）。

這裡還列出了所給類的版本号。如果某個方法是在這個版本之後添加的，就會給出一個單獨的版本号。

java.lang.string

1.0

char charat (int

index)

傳回給定位置的代碼單元。除非對底層的代碼單元感興趣，否則不需要調用這個方法。

int

codepointat(int index) 5.0

傳回從給定位置開始的碼點。

offsetbycodepoints(int startindex, int cpcount) 5.0

傳回從startindex代碼點開始，位移cpcount後的碼點索引。

compareto(string other)

按照字典順序，如果字元串位于other之前，傳回一個負數；如果字元串位于other之後，傳回一個正數；如果兩個字元串相等，傳回0。

intstream

codepoints() 8

将這個字元串的碼點作為一個流傳回。調用toarray将它們放在一個數組中。

new string(int[]

codepoints, int offset, int count) 5.0

用數組中從offset開始的count個碼點構造一個字元串。

boolean

equals(object other)

如果字元串與other相等，傳回true。

equalsignorecase(string other)

如果字元串與other相等（忽略大小寫），傳回true。

startswith(string pref?ix)

endswith(string suff?ix)

如果字元串以suff?ix開頭或結尾，則傳回true。

index0f(string str)

index0f(string str, int fromindex)

int index0f(int

cp)

cp, int fromindex)

傳回與字元串str或代碼點cp比對的第一個子串的開始位置。這個位置從索引0或fromindex開始計算。如果在原始串中不存在str，傳回-1。

int lastindex0f(string

str)

lastindex0f(string str, int fromindex)

lastindex0f(int cp)

lastindex0f(int cp, int fromindex)

傳回與字元串str或代碼點cp比對的最後一個子串的開始位置。這個位置從原始串尾端或fromindex開始計算。

int length( )

傳回字元串的長度。

codepointcount(int startindex, int endindex) 5.0

傳回startindex和endindex-1之間的代碼點數量。沒有配成對的代用字元将計入代碼點。

string

replace(charsequence oldstring,charsequence newstring)

傳回一個新字元串。這個字元串用newstring代替原始字元串中所有的oldstring。可以用string或stringbuilder對象作為charsequence參數。

substring(int beginindex)

substring(int beginindex, int endindex)

傳回一個新字元串。這個字元串包含原始字元串中從beginindex到串尾或endindex–1的所有代碼單元。

tolowercase( )

touppercase( )

傳回一個新字元串。這個字元串将原始字元串中的大寫字母改為小寫，或者将原始字元串中的所有小寫字母改成了大寫字母。

string trim( )

傳回一個新字元串。這個字元串将删除了原始字元串頭部和尾部的空格。

join(charsequence delimiter, charsequence... elements) 8

傳回一個新字元串，用給定的定界符連接配接所有元素。

      注釋：在api注釋中，有一些charsequence類型的參數。這是一種接口類型，所有字元串都屬于這個接口。第6章将介紹更多有關接口類型的内容。現在隻需要知道隻要看到一個charsequence形參，完全可以傳入string類型的實參。