Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

CharsetEncoder — codificar caracteres em bytes

CharsetEncoder converte caracteres Unicode em bytes de um conjunto de caracteres selecionado. Permite tratar erros de forma explícita e codificar um buffer completo ou partes sucessivas de texto.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);

CharsetEncoder, de java.nio.charset, codifica caracteres em bytes; CharsetDecoder faz o inverso. Crie um codificador com charset.newEncoder(), selecionando explicitamente o conjunto de caracteres.

CharsetEncoder.encode(CharBuffer) efetua a reposição, a codificação e o esvaziamento final do estado. Devolve um novo ByteBuffer pronto para leitura: a posição é zero e o limite assinala o fim dos dados. Não invoque este método durante uma operação em curso.

encode(in, out, endOfInput) avança as posições dos buffers e devolve CoderResult. Em caso de OVERFLOW, retire os bytes; em caso de UNDERFLOW, preserve os caracteres não consumidos antes de acrescentar mais. Inicie uma nova operação com reset() (desnecessário na primeira utilização); termine a codificação com endOfInput = true e, em seguida, chame flush(out) até obter UNDERFLOW.

O valor predefinido REPORT distingue UTF-16 malformado de caracteres válidos que não podem ser representados no conjunto de caracteres. A variante de buffer único lança CharacterCodingException; a variante em fluxo devolve um resultado de erro. IGNORE e REPLACE podem causar perda de informação. Não partilhe um codificador entre threads em execução simultânea.

Exemplos

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CharsetEncoder;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws CharacterCodingException {
        CharsetEncoder encoder = StandardCharsets.UTF_8.newEncoder();
        ByteBuffer bytes = encoder.encode(CharBuffer.wrap("A\u20AC"));
        while (bytes.hasRemaining()) {
            System.out.println(bytes.get() & 0xFF);
        }
    }
}

Resultado

65
226
130
172

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes