String 類別

定義

命名空間:

Java.Lang

組件:

Mono.Android.dll

類別 String 代表字元字串。

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>

[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable

繼承

Object

Object

String

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

備註

類別 String 代表字元字串。 Java 程式中的所有字串常值，例如 "abc"，都會實作為這個類別的實例。

字串是常數;建立值之後，就無法變更其值。 字串緩衝區支援可變動的字串。 因為 String 物件是不可變的，所以可以共享它們。 例如： <blockquote>

String str = "abc";

</blockquote>

相當於： <blockquote>

char data[] = {'a', 'b', 'c'};
                String str = new String(data);

</blockquote>

以下是一些如何使用字串的更多範例： <blockquote>

System.out.println("abc");
                String cde = "cde";
                System.out.println("abc" + cde);
                String c = "abc".substring(2,3);
                String d = cde.substring(1, 2);

</blockquote>

類別 String 包含檢查序列個別字元的方法、比較字串、搜尋字串、擷取子字串，以及建立字元串複本，並將所有字元轉譯成大寫或小寫。 案例對應是以 類別所 java.lang.Character Character 指定的 Unicode Standard 版本為基礎。

Java 語言提供字串串連運算符 ( + ) 的特殊支援，以及將其他物件轉換成字元串。 如需字串串連和轉換的其他資訊，請參閱 Java&交易;語言規格。

除非另有說明，否則將自變數傳遞 null 至這個類別中的建構函式或方法將會導致 NullPointerException 擲回 。

String代表UTF-16格式<的字串，其中em增補字元</em>是由<em>>surrogate pairs</em> 表示 (請參閱 類別中的 Character Unicode 字元表示法一節，以取得詳細資訊) 。 索引值是指 char 程式代碼單位，因此增補字元會在 中使用兩個 String位置。

類別 String 提供處理 Unicode 字碼點 (的方法，例如字元) ，以及處理 Unicode 程式代碼單位的方法，也就是 char 值 () 。

除非另有說明，否則比較字串的方法不會考慮地區設定。 類別 java.text.Collator 提供更精細、區分地區設定的字串比較方法。

已在1.0中新增。

的 java.lang.StringJava 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據 中所述的詞彙使用。

建構函式

String()	建立空字串。
String(Byte[])	使用平台的預設 charset 來譯碼指定的位元組陣列，以建構新的 String 。
String(Byte[], Charset)	使用指定的 java 譯碼指定的位元組數組，以建構新的 String 。
String(Byte[], Int32)	已淘汰. 配置新的 String 包含從8位整數值數組建構的字元。
String(Byte[], Int32, Int32)	使用平台的預設字元集來譯碼指定的位元組子陣列，以建構新的 String 。
String(Byte[], Int32, Int32, Charset)	使用指定的 java 譯碼指定的位元組子陣列，以建構新的 String 。
String(Byte[], Int32, Int32, Int32)	已淘汰. 配置從8位整數值數組子數組建構的新 String 建構。
String(Byte[], Int32, Int32, String)	使用指定的 charset 來譯碼指定的位元組子陣列，以建構新的 String 。
String(Byte[], String)	使用指定的 java 譯碼指定的位元組數組，以建構新的 String 。
String(Char[])	初始化這個字串以包含指定的 char。
String(Char[], Int32, Int32)	初始化這個字串以包含指定的 char。
String(Int32[], Int32, Int32)	配置新的 String ，其中包含 Unicode 字碼點陣列自變量子數位中的字元。
String(String)	建構具有與 相同字元 toCopy序列的新字串。
String(StringBuffer)	配置新的字串，其中包含目前包含在字串緩衝區自變數中的字元序列。
String(StringBuilder)	配置新的字串，其中包含目前包含在字串產生器自變數中的字元序列。

屬性

CaseInsensitiveOrder	將物件排序 String 為的 compareToIgnoreCase比較子。
Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Handle	基礎Android實例的句柄。 (繼承來源 Object)
IsBlank	true如果字串是空的，或只Character#isWhitespace(int) white space包含程式代碼點，則傳回 ，否則false為 。
IsEmpty	true如果 為 ，則傳回 ，且只有在 為 時 #length()0。
JniIdentityHashCode	類別 String 代表字元字串。 (繼承來源 Object)
JniPeerMembers	類別 String 代表字元字串。
PeerReference	類別 String 代表字元字串。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)

方法

CharAt(Int32)	傳 char 回位於指定索引處的值。
Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
CodePointAt(Int32)	傳回指定索引處) 的 Unicode 字碼點 (字元。
CodePointBefore(Int32)	傳回指定索引之前 (Unicode 字碼點) 字元。
CodePointCount(Int32, Int32)	傳回這個 String指定文字範圍中的 Unicode 字碼點數目。
CompareTo(String)	比較兩個字串語彙。
CompareToIgnoreCase(String)	比較兩個字串語彙，忽略大小寫差異。
Concat(String)	將指定的字串串連至這個字串的結尾。
Contains(ICharSequence)	只有在這個字串包含指定的char值序列時，才會傳回 true。
Contains(String)	只有在這個字串包含指定的char值序列時，才會傳回 true。
ContentEquals(ICharSequence)	將此字串與指定的 CharSequence比較。
ContentEquals(String)	將此字串與指定的 CharSequence比較。
ContentEquals(StringBuffer)	將此字串與指定的 StringBuffer比較。
CopyValueOf(Char[])	相當於 #valueOf(char[])。
CopyValueOf(Char[], Int32, Int32)	相當於 #valueOf(char[], int, int)。
Dispose()	類別 String 代表字元字串。 (繼承來源 Object)
Dispose(Boolean)	類別 String 代表字元字串。 (繼承來源 Object)
EndsWith(String)	測試此字串是否以指定的後綴結尾。
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
EqualsIgnoreCase(String)	將此與 String 另一個 String比較，忽略案例考慮。
Format(Locale, String, Object[])	使用指定的格式字串和自變數傳回格式化字串。
Format(String, Object[])	使用指定的格式字串和自變數傳回格式化字串。
Formatted(Object[])	類別 String 代表字元字串。
GetBytes()	使用平臺的預設字元集，將它 String 編碼為位元組序列，並將結果儲存至新的位元組數位數組。
GetBytes(Charset)	使用指定的java，將此 String 編碼為位元組序列。
GetBytes(Int32, Int32, Byte[], Int32)	已淘汰. 將這個字串中的字元複製到目的地位元組陣列。
GetBytes(String)	String使用具名 charset 將此項目編碼為位元組序列，並將結果儲存至新的位元組陣列。
GetChars(Int32, Int32, Char[], Int32)	將此字串中的字元複製到目的地字元陣列。
GetEnumerator()	類別 String 代表字元字串。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
Indent(Int32)	根據的值 n調整這個字串的每一行縮排，並正規化行終止字元。
IndexOf(Int32)	傳回此字串中第一次出現指定字元的索引。
IndexOf(Int32, Int32)	傳回此字串內第一次出現指定字元的索引，從指定索引處開始搜尋。
IndexOf(String)	傳回這個字串內第一次出現指定子字串的索引。
IndexOf(String, Int32)	傳回這個字串內第一次出現指定子字串的索引，從指定的索引開始。
Intern()	傳回字串對象的標準表示法。
JavaFinalize()	當垃圾收集判斷對象沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
Join(ICharSequence, ICharSequence[])	傳回由聯結之 CharSequence elements 複本與指定 delimiter複本所組成的新 String。
Join(ICharSequence, IIterable)	傳回新的 String 由聯結的 CharSequence elements 複本與指定 delimiter複本一起組成。
Join(String, IIterable)	傳回新的 String 由聯結的 CharSequence elements 複本與指定 delimiter複本一起組成。
Join(String, String[])	傳回由聯結之 CharSequence elements 複本與指定 delimiter複本所組成的新 String。
LastIndexOf(Int32)	傳回這個字串中最後一個出現指定字元的索引。
LastIndexOf(Int32, Int32)	傳回這個字串中最後一個出現指定字元的索引，從指定的索引開始往後搜尋。
LastIndexOf(String)	傳回這個字串內指定子字串最後一次出現的索引。
LastIndexOf(String, Int32)	傳回這個字串中最後一次出現指定子字串的索引，從指定的索引開始向後搜尋。
Length()	傳回此字串的長度。
Matches(String)	告知此字串是否符合指定的正則表達式。
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
OffsetByCodePoints(Int32, Int32)	傳回這個 String 內的索引，此索引會從程式代碼點指定的 indexcodePointOffset 位移。
RegionMatches(Boolean, Int32, String, Int32, Int32)	測試兩個字串區域是否相等。
RegionMatches(Int32, String, Int32, Int32)	測試兩個字串區域是否相等。
Repeat(Int32)	傳回字串，其值為這個字串重複 count 的串連。
Replace(Char, Char)	傳回字串，此字串會以 取代此字串newChar中出現的所有專案oldChar。
Replace(ICharSequence, ICharSequence)	使用指定的常值取代序列，取代此字串的每個子字串，以符合常值目標序列。
Replace(String, String)	使用指定的常值取代序列，取代此字串的每個子字串，以符合常值目標序列。
ReplaceAll(String, String)	使用指定的取代，取代此字串的每個子字串，該字串符合指定的正則表達式。
ReplaceFirst(String, String)	使用指定的取代，取代此字串的第一個子字串，該字串符合指定的正則表示式。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
Split(String)	將這個字串分割為指定正則表達式的相符專案。
Split(String, Int32)	將這個字串分割為指定正則表達式的相符專案。
StartsWith(String)	測試此字串是否以指定的前置詞開頭。
StartsWith(String, Int32)	測試此字串的子字串是否以指定的前置詞開頭。
Strip()	傳回字串，其值為這個字串，並移除所有前置和尾端 Character#isWhitespace(int) white space 。
StripIndent()	傳回字串，其值為這個字串，其中含有附附的 Character#isWhitespace (int) 從每一行開頭和結尾移除的空格符。
StripLeading()	傳回字串，其值為這個字串，並移除所有前置 Character#isWhitespace(int) white space 詞。
StripTrailing()	傳回字串，其值為這個字串，並移除所有尾端 Character#isWhitespace(int) white space 。
SubSequence(Int32, Int32)	傳回這個序列的子序列字元序列。
SubSequenceFormatted(Int32, Int32)	傳回這個序列的子序列字元序列。
Substring(Int32)	傳回字串，此字串為這個字串的子字串。
Substring(Int32, Int32)	傳回字串，此字串為這個字串的子字串。
ToArray<T>()	類別 String 代表字元字串。 (繼承來源 Object)
ToCharArray()	將此字串轉換成新的字元陣列。
ToLowerCase()	使用預設地區設定的規則，將此 String 中的所有字元轉換為小寫。
ToLowerCase(Locale)	使用指定Locale的規則，將此 String 中的所有字元轉換為小寫。
ToString()	類別 String 代表字元字串。
ToUpperCase()	使用預設地區設定的規則，將此 String 中的所有字元轉換為大寫。
ToUpperCase(Locale)	使用指定Locale的規則，將此 String 中的所有字元轉換為大寫。
Transform(IFunction)	這個方法允許將函式應用程式套用至 this 字串。
TranslateEscapes()	傳回字串，其值為這個字串，其逸出序列會轉譯為字串常值。
Trim()	傳回字串，其值為此字串，並移除所有前置和尾端空格，其中空格定義為任何代碼點小於或等於 'U+0020' (空格字元的字元) 。
UnregisterFromRuntime()	類別 String 代表字元字串。 (繼承來源 Object)
ValueOf(Boolean)	傳回自變數的 boolean 字串表示。
ValueOf(Char)	傳回自變數的 char 字串表示。
ValueOf(Char[])	傳回數位自變數的 char 字串表示。
ValueOf(Char[], Int32, Int32)	傳回數位自變數之特定子陣列的 char 字串表示。
ValueOf(Double)	傳回自變數的 double 字串表示。
ValueOf(Int32)	傳回自變數的 int 字串表示。
ValueOf(Int64)	傳回自變數的 long 字串表示。
ValueOf(Object)	傳回自變數的 Object 字串表示。
ValueOf(Single)	傳回自變數的 float 字串表示。
Wait()	讓目前的線程等到喚醒為止，通常是藉由 <em>notified</em> 或 <em>interrupted</em> 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

IComparable.CompareTo(Object)	類別 String 代表字元字串。
IEnumerable.GetEnumerator()	類別 String 代表字元字串。
IJavaPeerable.Disposed()	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.Finalized()	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別 String 代表字元字串。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別 String 代表字元字串。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 String 代表字元字串。
GetJniTypeName(IJavaPeerable)	類別 String 代表字元字串。
SubSequence(ICharSequence, Int32, Int32)	類別 String 代表字元字串。