StringBuilder 類別

定義

命名空間:

Java.Lang

組件:

Mono.Android.dll

可變動的字元序列。

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

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

繼承

Object

Object

AbstractStringBuilder

StringBuilder

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IAppendable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

備註

可變動的字元序列。 這個類別提供與 StringBuffer 相容的 API，但不保證同步處理。 這個類別的設計目的是為了在單一線程 (使用字串緩衝區的位置，做為卸載取代 StringBuffer ，一般情況為) 。 可能的話，建議將此類別用於喜好 StringBuffer 設定，因為大部分實作的實作速度會比較快。

上的 StringBuilder 主體作業是 append 和 insert 方法，這些方法會多載，以便接受任何類型的資料。 每個都會有效地將給定的日期轉換成字串，然後將該字串的字元附加或插入字串產生器。 方法 append 一律會在產生器結尾新增這些字元; insert 方法會在指定的點新增字元。

例如，如果 z 參考目前內容為 「 start 」 的字串產生器物件，則方法呼叫 z.append("le") 會導致字串產生器包含 「 startle 」，而 z.insert(4, "le") 會改變字串產生器以包含 「 starlet 」。

一般而言，如果 sb 參考 的 StringBuilder 實例，則 sb.append(x) 的效果會與 sb.insert(sb.length(), x) 相同。

每個字串產生器都有容量。 只要字串產生器中包含的字元序列長度未超過容量，就不需要配置新的內部緩衝區。 如果內部緩衝區溢位，它會自動變大。

的 StringBuilder 實例不安全，無法供多個執行緒使用。 如果需要這類同步處理，建議您使用 java.lang.StringBuffer 。

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

在 1.5 中新增。

的 java.lang.StringBuilder JAVA 檔。

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

建構函式

StringBuilder()	建構字串產生器，其中沒有字元，且初始容量為 16 個字元。
StringBuilder(ICharSequence)	建構字串產生器，其中包含與指定 CharSequence 相同的字元。
StringBuilder(Int32)	建構字串產生器，其中沒有字元，以及引數所 capacity 指定的初始容量。
StringBuilder(String)	建構初始化為指定字串內容的字串產生器。

屬性

Class	傳回這個 Object 的執行時間類別。 (繼承來源 Object)
Handle	基礎 Android 實例的控制碼。 (繼承來源 Object)
JniIdentityHashCode	可變動的字元序列。 (繼承來源 Object)
JniPeerMembers	可變動的字元序列。
PeerReference	可變動的字元序列。 (繼承來源 Object)
ThresholdClass	可變動的字元序列。 (繼承來源 AbstractStringBuilder)
ThresholdType	可變動的字元序列。 (繼承來源 AbstractStringBuilder)

方法

Append(Boolean)	附加指定 boolean 值的字串表示。
Append(Char)	附加指定 char 值的字串表示。
Append(Char[])	附加指定 char[] 之 的字串表示。
Append(Char[], Int32, Int32)	附加 所指定子集的 char[] 字串表示。
Append(Double)	附加指定 double 值的字串表示。
Append(ICharSequence)	附加指定 CharSequence 之 的字串表示。
Append(ICharSequence, Int32, Int32)	附加 所指定子序列的 CharSequence 字串表示。
Append(Int32)	附加指定 int 值的字串表示。
Append(Int64)	附加指定 long 值的字串表示。
Append(Object)	附加指定 Object 之 的字串表示。
Append(Single)	附加指定 float 值的字串表示。
Append(String)	附加指定字串的內容。
Append(String, Int32, Int32)	可變動的字元序列。
Append(StringBuffer)	將指定的 StringBuffer 附加至這個序列。
AppendCodePoint(Int32)	已在 1 中新增。
Capacity()	傳回可以在不成長的情況下保留的字元數。
CharAt(Int32)	傳回 位於 的 index 字元。
Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
CodePointAt(Int32)	擷取 位於 的 index Unicode 字碼點值。
CodePointBefore(Int32)	擷取位於 之前的 index Unicode 字碼點值。
CodePointCount(Int32, Int32)	計算 和 end 之間的 start Unicode 字碼點數目。
CompareTo(StringBuilder)	比較兩 StringBuilder 個實例的語彙。
Delete(Int32, Int32)	刪除 和 end 所 start 指定的字元序列。
DeleteCharAt(Int32)	刪除指定索引處的字元。 將剩餘的任何字元移向左。
Dispose()	可變動的字元序列。 (繼承來源 Object)
Dispose(Boolean)	可變動的字元序列。 (繼承來源 Object)
EnsureCapacity(Int32)	在要求放大內部緩衝區之前，請確定此物件具有可用的最小容量。
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetChars(Int32, Int32, Char[], Int32)	從 開始，將要求的字元序列複製到 dst 傳入。 dst
GetEnumerator()	可變動的字元序列。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
IndexOf(String)	搜尋指定字元的第一個索引。
IndexOf(String, Int32)	搜尋指定字元的索引。
Insert(Int32, Boolean)	在指定的 offset 處插入指定 boolean 值的字串表示。
Insert(Int32, Char)	在指定的 offset 處插入指定 char 值的字串表示。
Insert(Int32, Char[])	在指定的 插入所指定 char[]offset 之 的字串表示。
Insert(Int32, Char[], Int32, Int32)	在指定的 offset 處插入指定子序列的 char[] 字串表示。
Insert(Int32, Double)	在指定的 offset 處插入指定 double 值的字串表示。
Insert(Int32, ICharSequence)	在指定的 插入所指定 CharSequenceoffset 之 的字串表示。
Insert(Int32, ICharSequence, Int32, Int32)	在指定的 offset 處插入指定子序列的 CharSequence 字串表示。
Insert(Int32, Int32)	在指定的 offset 處插入指定 int 值的字串表示。
Insert(Int32, Int64)	在指定的 offset 處插入指定 long 值的字串表示。
Insert(Int32, Object)	在指定的 插入所指定 Objectoffset 之 的字串表示。
Insert(Int32, Single)	在指定的 offset 處插入指定 float 值的字串表示。
Insert(Int32, String)	將指定的字串插入指定的 offset 。
Insert(Int32, String, Int32, Int32)	可變動的字元序列。
JavaFinalize()	當垃圾收集判斷物件沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
LastIndexOf(String)	搜尋指定字元的最後一個索引。
LastIndexOf(String, Int32)	搜尋指定字元的索引。
Length()	目前的長度。
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
OffsetByCodePoints(Int32, Int32)	傳回從 index 位移 codePointOffset 代碼點的索引。
Replace(Int32, Int32, String)	以指定的字串取代這個產生器中指定的子序列。
Reverse()	反轉這個產生器中的字元順序。
SetCharAt(Int32, Char)	設定 位於 的 index 字元。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetLength(Int32)	將目前的長度設定為新的值。
SubSequence(Int32, Int32)	可變動的字元序列。
SubSequenceFormatted(Int32, Int32)	從 CharSequence 索引傳回子序列的 start ，傳回至 end 索引。
Substring(Int32)	從索引傳回子序列 start 的 String 值到目前結尾。
Substring(Int32, Int32)	從索引傳回子序列的 start String 值至 end 索引。
ToArray<T>()	可變動的字元序列。 (繼承來源 Object)
ToString()	傳回這個產生器的內容。
TrimToSize()	修剪超過目前長度的任何額外容量。
UnregisterFromRuntime()	可變動的字元序列。 (繼承來源 Object)
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)	可變動的字元序列。
IEnumerable.GetEnumerator()	可變動的字元序列。
IJavaPeerable.Disposed()	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.Finalized()	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	可變動的字元序列。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	可變動的字元序列。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	可變動的字元序列。
GetJniTypeName(IJavaPeerable)	可變動的字元序列。
Append(IAppendable, String)	可變動的字元序列。
Append(IAppendable, String, Int32, Int32)	可變動的字元序列。
SubSequence(ICharSequence, Int32, Int32)	可變動的字元序列。