CharsetEncoder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico.
[Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)]
public abstract class CharsetEncoder : Java.Lang.Object[<Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)>]
type CharsetEncoder = class
inherit Object- Herança
- Atributos
Comentários
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico.
"etapas">
A sequência de caracteres de entrada é fornecida em um buffer de caracteres ou em uma série desses buffers. A sequência de bytes de saída é gravada em um buffer de bytes ou em uma série desses buffers. Um codificador sempre deve ser usado fazendo a seguinte sequência de invocações de método, hereinafter conhecida como uma operação de codificação:
<ol>
<li>
Redefina o codificador por meio do #reset reset método, a menos que ele não tenha sido usado antes;
</li>
<li>
Invoque o #encode encode método zero ou mais vezes, desde que uma entrada adicional possa estar disponível, passando false para o endOfInput argumento e preenchendo o buffer de entrada e liberando o buffer de saída entre invocações;
</li>
<li>
Invoque o #encode encode método uma última vez, passando true para o endOfInput argumento; e, em seguida,
</li>
<li>
Invoque o #flush flush método para que o codificador possa liberar qualquer estado interno para o buffer de saída.
</li>
</ol>
Cada invocação do método codificará o #encode encode máximo de caracteres possível do buffer de entrada, gravando os bytes resultantes no buffer de saída. O #encode encode método retorna quando mais entrada é necessária, quando não há espaço suficiente no buffer de saída ou quando ocorreu um erro de codificação. Em cada caso, um CoderResult objeto é retornado para descrever o motivo do encerramento. Um invocador pode examinar esse objeto e preencher o buffer de entrada, liberar o buffer de saída ou tentar se recuperar de um erro de codificação, conforme apropriado, e tentar novamente.
"ce">
Há dois tipos gerais de erros de codificação. Se a sequência de caracteres de entrada não for uma sequência Unicode legal de dezesseis bits, a entrada será considerada malformada. Se a sequência de caracteres de entrada for legal, mas não puder ser mapeada para uma sequência de bytes válida no conjunto de caracteres especificado, um caractere inaplicaível será encontrado.
"cae">
A maneira como um erro de codificação é tratado depende da ação solicitada para esse tipo de erro, que é descrita por uma instância da CodingErrorAction classe. As ações de erro possíveis são para CodingErrorAction#IGNORE ignorar a entrada errônea, CodingErrorAction#REPORT relatar o erro para o invocador por meio do objeto retornado CoderResult ou CodingErrorAction#REPLACE substituir a entrada errônea pelo valor atual da matriz de bytes de substituição. A substituição
é inicialmente definido como a substituição padrão do codificador, que geralmente (mas nem sempre) tem o valor inicial { (byte)'?' };
seu valor pode ser alterado por meio do #replaceWith(byte[]) replaceWith método.
A ação padrão para erros de caractere de entrada malformada e não aplicaível é para CodingErrorAction#REPORT reportá-los. A ação de erro de entrada malformada pode ser alterada por meio do #onMalformedInput(CodingErrorAction) onMalformedInput método; a ação unmappable-character pode ser alterada por meio do #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter método.
Essa classe foi projetada para lidar com muitos dos detalhes do processo de codificação, incluindo a implementação de ações de erro. Um codificador para um conjunto de caracteres específico, que é uma subclasse concreta dessa classe, só precisa implementar o método abstrato #encodeLoop encodeLoop , que encapsula o loop de codificação básico. Uma subclasse que mantém o estado interno deve, além disso, substituir os métodos e #implReset implReset os #implFlush implFlush métodos.
As instâncias dessa classe não são seguras para uso por vários threads simultâneos.
Adicionado em 1.4.
Documentação Java para java.nio.charset.CharsetEncoder.
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 |
|---|---|
| CharsetEncoder(Charset, Single, Single, Byte[]) |
Inicializa um novo codificador. |
| CharsetEncoder(Charset, Single, Single) |
Inicializa um novo codificador. |
| CharsetEncoder(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| JniPeerMembers |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. |
| PeerReference |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (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. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
Métodos
| Nome | Description |
|---|---|
| AverageBytesPerChar() |
Retorna o número médio de bytes que serão produzidos para cada caractere de entrada. |
| CanEncode(Char) |
Informa se esse codificador pode ou não codificar o caractere determinado. |
| CanEncode(ICharSequence) |
Informa se esse codificador pode ou não codificar a sequência de caracteres fornecida. |
| CanEncode(String) |
Informa se esse codificador pode ou não codificar a sequência de caracteres fornecida. |
| Charset() |
Retorna o conjunto de caracteres que criou esse codificador. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| Dispose() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| Dispose(Boolean) |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| Encode(CharBuffer, ByteBuffer, Boolean) |
Codifica o máximo de caracteres possível do buffer de entrada fornecido, gravando os resultados no buffer de saída fornecido. |
| Encode(CharBuffer) |
Método de conveniência que codifica o conteúdo restante de um único buffer de caracteres de entrada em um buffer de bytes recém-alocado. |
| EncodeLoop(CharBuffer, ByteBuffer) |
Codifica um ou mais caracteres em um ou mais bytes. |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| Flush(ByteBuffer) |
Libera esse codificador. |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| ImplFlush(ByteBuffer) |
Libera esse codificador. |
| ImplOnMalformedInput(CodingErrorAction) |
Relata uma alteração na ação de entrada malformada desse codificador. |
| ImplOnUnmappableCharacter(CodingErrorAction) |
Relata uma alteração na ação de caractere inaplicaível desse codificador. |
| ImplReplaceWith(Byte[]) |
Relata uma alteração no valor de substituição desse codificador. |
| ImplReset() |
Redefine esse codificador, desmarcando qualquer estado interno específico do conjunto de caracteres. |
| IsLegalReplacement(Byte[]) |
Informa se a matriz de bytes fornecida é ou não um valor de substituição legal para esse codificador. |
| 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) |
| MalformedInputAction() |
Retorna a ação atual desse codificador para erros de entrada malformados. |
| MaxBytesPerChar() |
Retorna o número máximo de bytes que serão produzidos para cada caractere de entrada. |
| 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) |
| OnMalformedInput(CodingErrorAction) |
Altera a ação desse codificador para erros de entrada malformados. |
| OnUnmappableCharacter(CodingErrorAction) |
Altera a ação desse codificador para erros de caractere inaplicativo. |
| Replacement() |
Retorna o valor de substituição desse codificador. |
| ReplaceWith(Byte[]) |
Altera o valor de substituição desse codificador. |
| Reset() |
Redefine esse codificador, limpando qualquer estado interno. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| ToArray<T>() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnmappableCharacterAction() |
Retorna a ação atual desse codificador para erros de caractere inaplicativo. |
| UnregisterFromRuntime() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (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) |
| 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) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.Finalized() |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.JniManagedPeerState |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. (Herdado de Object) |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Um mecanismo que pode transformar uma sequência de caracteres Unicode de dezesseis bits em uma sequência de bytes em um conjunto de caracteres específico. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |