StringBuffer Classe

Definição

Namespace:

Java.Lang

Assembly:

Mono.Android.dll

Uma sequência mutável de caracteres thread-safe.

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

[<Android.Runtime.Register("java/lang/StringBuffer", DoNotGenerateAcw=true)>]
type StringBuffer = 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

StringBuffer

Atributos

RegisterAttribute

Implementações

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

Comentários

Uma sequência mutável de caracteres thread-safe. Um buffer de cadeia de caracteres é como um String, mas pode ser modificado. A qualquer momento, ele contém alguma sequência particular de caracteres, mas o comprimento e o conteúdo da sequência podem ser alterados através de certas chamadas de método.

Os buffers de cadeia de caracteres são seguros para uso por vários threads. Os métodos são sincronizados quando necessário para que todas as operações em qualquer instância específica se comportem como se ocorressem em alguma ordem serial que seja consistente com a ordem das chamadas de método feitas por cada um dos threads individuais envolvidos.

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

Por exemplo, se z se refere a um objeto de buffer de cadeia de caracteres cujo conteúdo atual é "start", a chamada z.append("le") de método faria com que o buffer de cadeia de caracteres contivesse "startle", enquanto z.insert(4, "le") alteraria o buffer de cadeia de caracteres para conter "starlet".

Em geral, se sb se refere a uma instância de um StringBuffer, então sb.append(x) tem o mesmo efeito que sb.insert(sb.length(), x).

Sempre que ocorre uma operação envolvendo uma sequência de origem (como anexar ou inserir de uma sequência de origem), essa classe é sincronizada somente no buffer de sequência de caracteres que executa a operação, não na origem. Observe que, embora StringBuffer tenha sido projetado para ser seguro usar simultaneamente de vários threads, se o construtor ou a append operação OR insert for passada uma sequência de origem que é compartilhada entre threads, o código de chamada deve garantir que a operação tenha uma exibição consistente e imutável da sequência de origem durante a operação. Isso pode ser satisfeito se o chamador segurar um bloqueio durante a chamada da operação, usando uma sequência de origem imutável ou não compartilhando a sequência de origem entre threads.

Cada buffer de cadeia de caracteres tem uma capacidade. Desde que o comprimento da sequência de caracteres contida no buffer de sequência de caracteres não exceda a capacidade, não é necessário alocar uma nova matriz de buffer interna. Se o buffer interno estourar, ele será automaticamente aumentado.

Salvo indicação em contrário, passar um null argumento para um construtor ou método nesta classe fará com que um NullPointerException seja lançado.

A partir da versão JDK 5, essa classe foi complementada com uma classe equivalente projetada para uso por um único thread, StringBuilder. A StringBuilder classe geralmente deve ser usada em preferência a esta, pois suporta todas as mesmas operações, mas é mais rápida, pois não executa sincronização.

Adicionado em 1.0.

Documentação Java para java.lang.StringBuffer.

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

Construtores

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

Propriedades

Class	Retorna a classe de tempo de execução 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 thread-safe. (Herdado de Object)
JniPeerMembers	Uma sequência mutável de caracteres thread-safe.
PeerReference	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
ThresholdClass	Uma sequência mutável de caracteres thread-safe. (Herdado de AbstractStringBuilder)
ThresholdType	Uma sequência mutável de caracteres thread-safe. (Herdado de AbstractStringBuilder)

Métodos

Append(Boolean)	Adiciona a representação de cadeia de caracteres do booleano especificado ao final deste StringBuffer.
Append(Char)	Adiciona o caractere especificado ao final desse buffer.
Append(Char[])	Adiciona a matriz de caracteres ao final desse buffer.
Append(Char[], Int32, Int32)	Adiciona a sequência especificada de caracteres ao final desse buffer.
Append(Double)	Adiciona a representação de cadeia de caracteres do duplo especificado ao final deste StringBuffer.
Append(ICharSequence)	Acrescenta o especificado CharSequence a esta sequência.
Append(ICharSequence, Int32, Int32)	Adicionado em 1.
Append(Int32)	Adiciona a representação de cadeia de caracteres do inteiro especificado ao final deste StringBuffer.
Append(Int64)	Adiciona a representação de cadeia de caracteres do longo especificado ao final deste StringBuffer.
Append(Object)	Adiciona a representação de cadeia de caracteres do objeto especificado ao final deste StringBuffer.
Append(Single)	Adiciona a representação de cadeia de caracteres do float especificado ao final deste StringBuffer.
Append(String)	Adiciona a cadeia de caracteres especificada ao final desse buffer.
Append(String, Int32, Int32)	Uma sequência mutável de caracteres thread-safe.
Append(StringBuffer)	Acrescenta o especificado StringBuffer a esta sequência.
AppendCodePoint(Int32)	Adicionado em 1.
Capacity()	Retorna o número de caracteres que podem ser mantidos sem crescer.
CharAt(Int32)	Retorna o caractere em index.
Clone()	Cria e retorna uma cópia desse objeto. (Herdado de Object)
CodePointAt(Int32)	Adicionado em 1.
CodePointBefore(Int32)	Adicionado em 1.
CodePointCount(Int32, Int32)	Adicionado em 1.
CompareTo(StringBuffer)	Compara duas StringBuffer instâncias lexicograficamente.
Delete(Int32, Int32)	Adicionado em 1.
DeleteCharAt(Int32)	Adicionado em 1.
Dispose()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
Dispose(Boolean)	Uma sequência mutável de caracteres thread-safe. (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 solicitada de caracteres para o char[] passado começando em idx.
GetEnumerator()	Uma sequência mutável de caracteres thread-safe.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
IndexOf(String)	Adicionado em 1.
IndexOf(String, Int32)	Adicionado em 1.
Insert(Int32, Boolean)	Insere a representação de cadeia de caracteres do booleano especificado nesse buffer no deslocamento especificado.
Insert(Int32, Char)	Insere o caractere nesse buffer no deslocamento especificado.
Insert(Int32, Char[])	Insere a matriz de caracteres nesse buffer no deslocamento especificado.
Insert(Int32, Char[], Int32, Int32)	Adicionado em 1.
Insert(Int32, Double)	Insere a representação de cadeia de caracteres do especificado neste buffer duplo no deslocamento especificado.
Insert(Int32, ICharSequence)	Adicionado em 1.
Insert(Int32, ICharSequence, Int32, Int32)	Adicionado em 1.
Insert(Int32, Int32)	Insere a representação de cadeia de caracteres do inteiro especificado nesse buffer no deslocamento especificado.
Insert(Int32, Int64)	Insere a representação de cadeia de caracteres do longo especificado nesse buffer no deslocamento especificado.
Insert(Int32, Object)	Insere a representação de cadeia de caracteres do objeto especificado nesse buffer no deslocamento especificado.
Insert(Int32, Single)	Insere a representação de cadeia de caracteres do float especificado nesse buffer no deslocamento especificado.
Insert(Int32, String)	Insere a cadeia de caracteres nesse buffer no deslocamento especificado.
Insert(Int32, String, Int32, Int32)	Adicionado em 1.
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)	Adicionado em 1.
LastIndexOf(String, Int32)	Adicionado em 1.
Length()	O comprimento atual.
Notify()	Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object)
NotifyAll()	Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object)
OffsetByCodePoints(Int32, Int32)	Adicionado em 1.
Replace(Int32, Int32, String)	Adicionado em 1.
Reverse()	Adicionado em 1.
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)	Adicionado em 1.
SubSequenceFormatted(Int32, Int32)	Adicionado em 1.
Substring(Int32)	Adicionado em 1.
Substring(Int32, Int32)	Adicionado em 1.
ToArray<T>()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
ToString()	Retorna a representação String atual.
TrimToSize()	Adicionado em 1.
UnregisterFromRuntime()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que ele seja ativado, normalmente sendo <em notificado</em> ou <em>interrompido</em>>. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa 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 sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa 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 thread-safe.
IEnumerable.GetEnumerator()	Uma sequência mutável de caracteres thread-safe.
IJavaPeerable.Disposed()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.Finalized()	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.JniManagedPeerState	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Uma sequência mutável de caracteres thread-safe. (Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Uma sequência mutável de caracteres thread-safe.
GetJniTypeName(IJavaPeerable)	Uma sequência mutável de caracteres thread-safe.
Append(IAppendable, String)	Uma sequência mutável de caracteres thread-safe.
Append(IAppendable, String, Int32, Int32)	Uma sequência mutável de caracteres thread-safe.
SubSequence(ICharSequence, Int32, Int32)	Uma sequência mutável de caracteres thread-safe.