StringBuilder Класс

Определение

Пространство имен:: Java.Lang

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменяемая последовательность символов.

[Android.Runtime.Register("java/lang/StringBuilder", DoNotGenerateAcw=true)]
public sealed class StringBuilder : Java.Lang.AbstractStringBuilder, IDisposable, 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

JavaObject

Object

AbstractStringBuilder
StringBuilder

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable ISerializable IAppendable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Изменяемая последовательность символов. Этот класс предоставляет API, совместимый с StringBuffer, но без гарантии синхронизации. Этот класс предназначен для использования в качестве замены StringBuffer раскрывающегося списка в тех местах, где буфер строки использовался одним потоком (как правило, в этом случае). По возможности рекомендуется использовать этот класс в предпочтениях StringBuffer , так как он будет быстрее в большинстве реализаций.

Основные операции с a StringBuilder — это append и insert методы, которые перегружены таким образом, чтобы принимать данные любого типа. Каждый из них фактически преобразует заданный datum в строку, а затем добавляет или вставляет символы этой строки в построитель строк. Метод 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 документации по java.lang.StringBuilder.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя.	Описание
StringBuilder()	Создает построитель строк без символов в нем и начальную емкость 16 символов.
StringBuilder(ICharSequence)	Создает построитель строк, содержащий те же символы, что и указанные `CharSequence`.
StringBuilder(Int32)	Создает построитель строк без символов в нем и начальную емкость, указанную аргументом `capacity` .
StringBuilder(String)	Создает построитель строк, инициализированный содержимому указанной строки.

Свойства

Имя.	Описание
Class	Возвращает класс среды выполнения этого `Object`объекта. (Унаследовано от Object)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Изменяемая последовательность символов. (Унаследовано от JavaObject)
JniPeerMembers	Возвращает метаданные JNI, используемые для вызова элементов этого Java однорангового узла.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от AbstractStringBuilder)
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от AbstractStringBuilder)

Методы

Имя.	Описание
Append(Boolean)	Добавляет строковое представление указанного `boolean` значения.
Append(Char)	Добавляет строковое представление указанного `char` значения.
Append(Char[], Int32, Int32)	Добавляет строковое представление указанного `char[]`подмножества объекта.
Append(Char[])	Добавляет строковое представление указанного `char[]`.
Append(Double)	Добавляет строковое представление указанного `double` значения.
Append(ICharSequence, Int32, Int32)	Добавляет строковое представление указанного подчиненного `CharSequence`параметров.
Append(ICharSequence)	Добавляет строковое представление указанного `CharSequence`.
Append(Int32)	Добавляет строковое представление указанного `int` значения.
Append(Int64)	Добавляет строковое представление указанного `long` значения.
Append(Object)	Добавляет строковое представление указанного `Object`.
Append(Single)	Добавляет строковое представление указанного `float` значения.
Append(String, Int32, Int32)	Добавляет указанное значение в эту последовательность символов.
Append(String)	Добавляет содержимое указанной строки.
Append(StringBuffer)	Добавляет указанный `StringBuffer` в эту последовательность.
AppendCodePoint(Int32)	Добавлено в 1.
Capacity()	Возвращает количество символов, которые можно хранить, не увеличиваясь.
CharAt(Int32)	Возвращает символ в `index`.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CodePointAt(Int32)	Извлекает значение точки кода Юникода в объекте `index`.
CodePointBefore(Int32)	Извлекает значение точки кода Юникода, предшествующее значению `index`.
CodePointCount(Int32, Int32)	Вычисляет количество точек кода Юникода между `start` и `end`.
CompareTo(StringBuilder)	Сравнивает два `StringBuilder` экземпляра лексографически.
Construct(JniObjectReference, JniObjectReferenceOptions)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
Delete(Int32, Int32)	Удаляет последовательность символов, заданных `start` и `end`.
DeleteCharAt(Int32)	Удаляет символ по указанному индексу. Сдвигает оставшиеся символы влево.
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Изменяемая последовательность символов. (Унаследовано от JavaObject)
EnsureCapacity(Int32)	Убедитесь, что этот объект имеет минимальную емкость, прежде чем требуется увеличить внутренний буфер.
Equals(Object)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
GetChars(Int32, Int32, Char[], Int32)	Копирует запрошенную последовательность символов, `dst` передаваемую начиная с `dst`.
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию символов в этой последовательности.
GetHashCode()	Возвращает хэш-значение кода для объекта. (Унаследовано от Object)
IndexOf(String, Int32)	Выполняет поиск индекса указанного символа.
IndexOf(String)	Выполняет поиск первого индекса указанного символа.
Insert(Int32, Boolean)	Вставляет строковое представление указанного значения по указанному `boolean` значению `offset`.
Insert(Int32, Char)	Вставляет строковое представление указанного значения по указанному `char` значению `offset`.
Insert(Int32, Char[], Int32, Int32)	Вставляет строковое представление указанного подчиненного значения указанного `char[]offset`значения.
Insert(Int32, Char[])	Вставляет строковое представление указанного в указанном `char[]offset`объекте.
Insert(Int32, Double)	Вставляет строковое представление указанного значения по указанному `double` значению `offset`.
Insert(Int32, ICharSequence, Int32, Int32)	Вставляет строковое представление указанного подчиненного значения указанного `CharSequenceoffset`значения.
Insert(Int32, ICharSequence)	Вставляет строковое представление указанного в указанном `CharSequenceoffset`объекте.
Insert(Int32, Int32)	Вставляет строковое представление указанного значения по указанному `int` значению `offset`.
Insert(Int32, Int64)	Вставляет строковое представление указанного значения по указанному `long` значению `offset`.
Insert(Int32, Object)	Вставляет строковое представление указанного в указанном `Objectoffset`объекте.
Insert(Int32, Single)	Вставляет строковое представление указанного значения по указанному `float` значению `offset`.
Insert(Int32, String, Int32, Int32)	Вставляет указанное значение в эту последовательность символов.
Insert(Int32, String)	Вставляет указанную строку по указанному объекту `offset`.
JavaFinalize()	Устаревшие. Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
LastIndexOf(String, Int32)	Выполняет поиск индекса указанного символа.
LastIndexOf(String)	Выполняет поиск последнего индекса указанного символа.
Length()	Текущая длина.
Notify()	Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
OffsetByCodePoints(Int32, Int32)	Возвращает индекс, в который входит смещение `codePointOffset` точек кода.`index`
Repeat(ICharSequence, Int32)	Добавляет копии указанной cs CharSequence cs в эту последовательность.
Repeat(Int32, Int32)	Повторяет количество копий строкового представления аргумента CodePoint в этой последовательности.
Repeat(String, Int32)	Изменяемая последовательность символов.
Replace(Int32, Int32, String)	Заменяет указанную подсезону в этом построителе указанной строкой.
Reverse()	Изменяет порядок символов в этом построителе.
SetCharAt(Int32, Char)	Задает символ в поле `index`.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetLength(Int32)	Задает текущую длину новым значением.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
SubSequence(Int32, Int32)	Возвращает подсезону символов в указанном диапазоне.
SubSequenceFormatted(Int32, Int32)	`CharSequence` Возвращает подсезону из `start` индекса к индексу`end`.
Substring(Int32, Int32)	Возвращает строковое значение вложенных параметров из `start` индекса к индексу `end` .
Substring(Int32)	Возвращает строковое значение вложенных параметров из `start` индекса к текущему концу.
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает содержимое этого построителя.
TrimToSize()	Обрезает дополнительную емкость за пределами текущей длины.
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

Имя.	Описание
IComparable.CompareTo(Object)	Сравнивает это значение с указанным объектом для упорядочивания.
IEnumerable.GetEnumerator()	Возвращает не универсальный перечислитель для символов в этой последовательности.
IJavaPeerable.Disposed()	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Изменяемая последовательность символов. (Унаследовано от JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Изменяемая последовательность символов.

Методы расширения

Имя.	Описание
Append(IAppendable, String, Int32, Int32)	Добавляет указанное значение в эту последовательность символов.
Append(IAppendable, String)	Добавляет указанное значение в эту последовательность символов.
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Изменяемая последовательность символов.
SubSequence(ICharSequence, Int32, Int32)	Возвращает подсезону символов в указанном диапазоне.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к