StringBuffer Classe

Definição

Namespace:

Java.Lang

Assembly:

Mono.Android.dll

Uma sequência mutável e segura de threads de caracteres.

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

JavaObject

Object

AbstractStringBuilder

StringBuffer

Atributos

RegisterAttribute

Implementações

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

Comentários

Uma sequência mutável e segura de threads de caracteres. Um buffer de cadeia de caracteres é como um String, mas pode ser modificado. A qualquer momento, ele contém uma sequência específica de caracteres, mas o comprimento e o conteúdo da sequência podem ser alterados por meio de determinadas 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 consistente com a ordem das chamadas de método feitas por cada um dos threads individuais envolvidos.

As operações principais em um StringBuffer são os append métodos e insert , que são sobrecarregados, de modo a 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 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 referir a um objeto de buffer de cadeia de caracteres cujo conteúdo atual está "start", a chamada z.append("le") de método fará com que o buffer de cadeia de caracteres contenha "startle", enquanto z.insert(4, "le") alteraria o buffer de cadeia de caracteres para conter "starlet".

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

Sempre que ocorre uma operação envolvendo uma sequência de origem (como acrescentar ou inserir de uma sequência de origem), essa classe sincroniza apenas no buffer de cadeia de caracteres que executa a operação, não na origem. Observe que, embora StringBuffer seja projetado para ser seguro para usar simultaneamente de vários threads, se o construtor ou a operação for passado por uma sequência de origem appendinsert compartilhada entre threads, o código de chamada deverá 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 atendido pelo chamador que mantém 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 contido no buffer de cadeia de caracteres não exceda a capacidade, não é necessário alocar uma nova matriz de buffer interno. Se o buffer interno estourar, ele será automaticamente maior.

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.

A partir do lançamento do 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 para esta, pois dá suporte a todas as mesmas operações, mas é mais rápida, pois não executa nenhuma 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 usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Construtores

Nome	Description
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 no conteúdo da cadeia de caracteres especificada.

Propriedades

Nome	Description
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	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
JniPeerMembers	Obtém os metadados JNI usados para invocar membros desse par Java.
PeerReference	Obtém a referência de objeto JNI para este par Java. (Herdado de Object)
ThresholdClass	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de AbstractStringBuilder)
ThresholdType	Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de AbstractStringBuilder)

Métodos

Nome	Description
Append(Boolean)	Adiciona a representação de cadeia de caracteres do booliano especificado ao final deste StringBuffer.
Append(Char)	Adiciona o caractere especificado ao final desse buffer.
Append(Char[], Int32, Int32)	Adiciona a sequência de caracteres especificada ao final desse buffer.
Append(Char[])	Adiciona a matriz 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, Int32, Int32)	Adicionado em 1.
Append(ICharSequence)	Acrescenta o especificado CharSequence a essa sequência.
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, Int32, Int32)	Acrescenta o valor especificado a essa sequência de caracteres.
Append(String)	Adiciona a cadeia de caracteres especificada ao final desse buffer.
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 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.
Construct(JniObjectReference, JniObjectReferenceOptions)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
Delete(Int32, Int32)	Adicionado em 1.
DeleteCharAt(Int32)	Adicionado em 1.
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
EnsureCapacity(Int32)	Garante que esse objeto tenha uma capacidade mínima disponível antes de exigir que o buffer interno seja ampliado.
Equals(Object)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
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 o char[] passado começando em idx.
GetEnumerator()	Retorna um enumerador que itera por meio dos caracteres nesta sequência.
GetHashCode()	Retorna um valor de código hash para o objeto. (Herdado de Object)
IndexOf(String, Int32)	Adicionado em 1.
IndexOf(String)	Adicionado em 1.
Insert(Int32, Boolean)	Insere a representação de cadeia de caracteres do booliano especificado nesse buffer no deslocamento especificado.
Insert(Int32, Char)	Insere o caractere nesse buffer no deslocamento especificado.
Insert(Int32, Char[], Int32, Int32)	Adicionado em 1.
Insert(Int32, Char[])	Insere a matriz de caracteres nesse buffer no deslocamento especificado.
Insert(Int32, Double)	Insere a representação de cadeia de caracteres do especificado nesse buffer duplo no deslocamento especificado.
Insert(Int32, ICharSequence, Int32, Int32)	Adicionado em 1.
Insert(Int32, ICharSequence)	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, Int32, Int32)	Adicionado em 1.
Insert(Int32, String)	Insere a cadeia de caracteres nesse buffer no deslocamento especificado.
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, Int32)	Adicionado em 1.
LastIndexOf(String)	Adicionado em 1.
Length()	O comprimento atual.
Notify()	Ativa um único thread que está aguardando no monitor desse 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.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
SubSequence(Int32, Int32)	Adicionado em 1.
SubSequenceFormatted(Int32, Int32)	Adicionado em 1.
Substring(Int32, Int32)	Adicionado em 1.
Substring(Int32)	Adicionado em 1.
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object)
ToString()	Retorna a representação de cadeia de caracteres atual.
TrimToSize()	Adicionado em 1.
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object)
Wait()	Faz com que o thread atual aguarde até que seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <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

Nome	Description
IComparable.CompareTo(Object)	Compara esse valor com o objeto especificado para ordenação.
IEnumerable.GetEnumerator()	Retorna um enumerador não genérico para os caracteres nesta sequência.
IJavaPeerable.Disposed()	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
IJavaPeerable.Finalized()	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Uma sequência mutável e segura de threads de caracteres. (Herdado de JavaObject)

Métodos de Extensão

Nome	Description
Append(IAppendable, String, Int32, Int32)	Acrescenta o valor especificado a essa sequência de caracteres.
Append(IAppendable, String)	Acrescenta o valor especificado a essa sequência de caracteres.
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada pelo tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Uma sequência mutável e segura de threads de caracteres.
SubSequence(ICharSequence, Int32, Int32)	Retorna a subsequência de caractere dentro do intervalo especificado.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.