StringBuilder Classe

Definição

Namespace:

Java.Lang

Assembly:

Mono.Android.dll

Uma sequência mutável de caracteres.

[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

Herança

Object

Object

AbstractStringBuilder

StringBuilder

Atributos

RegisterAttribute

Implementações

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

Comentários

Uma sequência mutável de caracteres. Essa classe fornece uma API compatível com StringBuffer, mas sem nenhuma garantia de sincronização. Essa classe foi projetada para ser usada como uma substituição suspensa para StringBuffer em locais em que o buffer de cadeia de caracteres estava sendo usado por um único thread (como geralmente é o caso). Sempre que possível, é recomendável que essa classe seja usada em preferência para StringBuffer , pois ela será mais rápida na maioria das implementações.

As operações de entidade de segurança em um StringBuilder são os append métodos e insert , que são sobrecarregados para aceitar dados de qualquer tipo. Cada um converte efetivamente um determinado datum em uma cadeia de caracteres e, em seguida, acrescenta ou insere os caracteres dessa cadeia de caracteres no construtor de cadeia de caracteres. O append método sempre adiciona esses caracteres no final do construtor; o insert método adiciona os caracteres em um ponto especificado.

Por exemplo, se z se referir a um objeto de construtor de cadeia de caracteres cujo conteúdo atual é "start", a chamada z.append("le") de método fará com que o construtor de cadeias de caracteres contenha "startle", enquanto z.insert(4, "le") alteraria o construtor de cadeias de caracteres para conter "starlet".

Em geral, se sb se referir a uma instância de um StringBuilder, terá sb.append(x) o mesmo efeito que sb.insert(sb.length(), x).

Cada construtor de cadeia de caracteres tem uma capacidade. Desde que o comprimento da sequência de caracteres contida no construtor de cadeias de caracteres não exceda a capacidade, não é necessário alocar um novo buffer interno. Se o buffer interno estourar, ele será automaticamente maior.

As instâncias do StringBuilder não são seguras para uso por vários threads. Se essa sincronização for necessária, é recomendável que java.lang.StringBuffer ela seja usada.

A menos que indicado de outra forma, passar um null argumento para um construtor ou método nessa classe fará com que um NullPointerException seja gerado.

Adicionado em 1.5.

Documentação do Java para java.lang.StringBuilder.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Source Project e usadas de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Construtores

StringBuilder()	Constrói um construtor de cadeia de caracteres sem caracteres e uma capacidade inicial de 16 caracteres.
StringBuilder(ICharSequence)	Constrói um construtor de cadeia de caracteres que contém os mesmos caracteres que o especificado CharSequence.
StringBuilder(Int32)	Constrói um construtor de cadeia de caracteres sem caracteres e uma capacidade inicial especificada pelo capacity argumento .
StringBuilder(String)	Constrói um construtor de cadeia de caracteres inicializado para o conteúdo da cadeia de caracteres especificada.

Propriedades

Class	Retorna a classe de runtime deste Object. (Herdado de Object)
Handle	O identificador para a instância subjacente do Android. (Herdado de Object)
JniIdentityHashCode	Uma sequência mutável de caracteres. (Herdado de Object)
JniPeerMembers	Uma sequência mutável de caracteres.
PeerReference	Uma sequência mutável de caracteres. (Herdado de Object)
ThresholdClass	Uma sequência mutável de caracteres. (Herdado de AbstractStringBuilder)
ThresholdType	Uma sequência mutável de caracteres. (Herdado de AbstractStringBuilder)

Métodos

Append(Boolean)	Acrescenta a representação de cadeia de caracteres do valor especificado boolean .
Append(Char)	Acrescenta a representação de cadeia de caracteres do valor especificado char .
Append(Char[])	Acrescenta a representação de cadeia de caracteres do especificado char[].
Append(Char[], Int32, Int32)	Acrescenta a representação de cadeia de caracteres do subconjunto especificado do char[].
Append(Double)	Acrescenta a representação de cadeia de caracteres do valor especificado double .
Append(ICharSequence)	Acrescenta a representação de cadeia de caracteres do especificado CharSequence.
Append(ICharSequence, Int32, Int32)	Acrescenta a representação de cadeia de caracteres da subsequência especificada do CharSequence.
Append(Int32)	Acrescenta a representação de cadeia de caracteres do valor especificado int .
Append(Int64)	Acrescenta a representação de cadeia de caracteres do valor especificado long .
Append(Object)	Acrescenta a representação de cadeia de caracteres do especificado Object.
Append(Single)	Acrescenta a representação de cadeia de caracteres do valor especificado float .
Append(String)	Acrescenta o conteúdo da cadeia de caracteres especificada.
Append(String, Int32, Int32)	Uma sequência mutável de caracteres.
Append(StringBuffer)	Acrescenta o especificado StringBuffer a essa sequência.
AppendCodePoint(Int32)	Adicionado em 1.
Capacity()	Retorna o número de caracteres que podem ser mantidos sem crescimento.
CharAt(Int32)	Retorna o caractere em index.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
CodePointAt(Int32)	Recupera o valor do ponto de código Unicode no index.
CodePointBefore(Int32)	Recupera o valor do ponto de código Unicode que precede o index.
CodePointCount(Int32, Int32)	Calcula o número de pontos de código Unicode entre start e end.
CompareTo(StringBuilder)	Compara duas StringBuilder instâncias lexicograficamente.
Delete(Int32, Int32)	Exclui uma sequência de caracteres especificada por start e end.
DeleteCharAt(Int32)	Exclui o caractere no índice especificado. desloca todos os caracteres restantes para a esquerda.
Dispose()	Uma sequência mutável de caracteres. (Herdado de Object)
Dispose(Boolean)	Uma sequência mutável de caracteres. (Herdado de Object)
EnsureCapacity(Int32)	Garante que esse objeto tenha uma capacidade mínima disponível antes de exigir que o buffer interno seja ampliado.
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
GetChars(Int32, Int32, Char[], Int32)	Copia a sequência de caracteres solicitada para dst passados começando em dst.
GetEnumerator()	Uma sequência mutável de caracteres.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
IndexOf(String)	Pesquisa o primeiro índice do caractere especificado.
IndexOf(String, Int32)	Pesquisa o índice do caractere especificado.
Insert(Int32, Boolean)	Insere a representação de cadeia de caracteres do valor especificado boolean no especificado offset.
Insert(Int32, Char)	Insere a representação de cadeia de caracteres do valor especificado char no especificado offset.
Insert(Int32, Char[])	Insere a representação de cadeia de caracteres do especificado char[] no especificado offset.
Insert(Int32, Char[], Int32, Int32)	Insere a representação de cadeia de caracteres da subsequência especificada do char[] no especificado offset.
Insert(Int32, Double)	Insere a representação de cadeia de caracteres do valor especificado double no especificado offset.
Insert(Int32, ICharSequence)	Insere a representação de cadeia de caracteres do especificado CharSequence no especificado offset.
Insert(Int32, ICharSequence, Int32, Int32)	Insere a representação de cadeia de caracteres da subsequência especificada do CharSequence no especificado offset.
Insert(Int32, Int32)	Insere a representação de cadeia de caracteres do valor especificado int no especificado offset.
Insert(Int32, Int64)	Insere a representação de cadeia de caracteres do valor especificado long no especificado offset.
Insert(Int32, Object)	Insere a representação de cadeia de caracteres do especificado Object no especificado offset.
Insert(Int32, Single)	Insere a representação de cadeia de caracteres do valor especificado float no especificado offset.
Insert(Int32, String)	Insere a cadeia de caracteres especificada no especificado offset.
Insert(Int32, String, Int32, Int32)	Uma sequência mutável de caracteres.
JavaFinalize()	Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object)
LastIndexOf(String)	Pesquisa o último índice do caractere especificado.
LastIndexOf(String, Int32)	Pesquisa o índice do caractere especificado.
Length()	O comprimento atual.
Notify()	Ativa um único thread que está aguardando o monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando o monitor deste objeto. (Herdado de Object)
OffsetByCodePoints(Int32, Int32)	Retorna o índice que é deslocamento codePointOffset de pontos de código de index.
Replace(Int32, Int32, String)	Substitui a subsequência especificada nesse construtor pela cadeia de caracteres especificada.
Reverse()	Inverte a ordem dos caracteres neste construtor.
SetCharAt(Int32, Char)	Define o caractere no index.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle. (Herdado de Object)
SetLength(Int32)	Define o comprimento atual como um novo valor.
SubSequence(Int32, Int32)	Uma sequência mutável de caracteres.
SubSequenceFormatted(Int32, Int32)	Retorna um CharSequence da subsequência do start índice para o end índice.
Substring(Int32)	Retorna o valor String da subsequência do start índice para o final atual.
Substring(Int32, Int32)	Retorna o valor String da subsequência do start índice para o end índice.
ToArray<T>()	Uma sequência mutável de caracteres. (Herdado de Object)
ToString()	Retorna o conteúdo desse construtor.
TrimToSize()	Corta qualquer capacidade extra além do comprimento atual.
UnregisterFromRuntime()	Uma sequência mutável de caracteres. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em> ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em> ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

IComparable.CompareTo(Object)	Uma sequência mutável de caracteres.
IEnumerable.GetEnumerator()	Uma sequência mutável de caracteres.
IJavaPeerable.Disposed()	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.Finalized()	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Uma sequência mutável de caracteres. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Uma sequência mutável de caracteres. (Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificado em runtime do Android.
JavaCast<TResult>(IJavaObject)	Uma sequência mutável de caracteres.
GetJniTypeName(IJavaPeerable)	Uma sequência mutável de caracteres.
Append(IAppendable, String)	Uma sequência mutável de caracteres.
Append(IAppendable, String, Int32, Int32)	Uma sequência mutável de caracteres.
SubSequence(ICharSequence, Int32, Int32)	Uma sequência mutável de caracteres.