Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

CharsetEncoder — codificare caratteri in byte

CharsetEncoder converte i caratteri Unicode in byte usando un set di caratteri selezionato. Consente di gestire esplicitamente gli errori e di codificare un intero buffer oppure porzioni successive di testo.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

CharsetEncoder di java.nio.charset codifica i caratteri in byte; CharsetDecoder esegue l’operazione inversa. Crea un encoder con charset.newEncoder(), scegliendo esplicitamente il set di caratteri.

CharsetEncoder.encode(CharBuffer) esegue il reset, la codifica e lo svuotamento finale dello stato. Restituisce un nuovo ByteBuffer pronto per la lettura: la posizione è zero e il limite indica la fine dei dati. Non chiamare questo metodo durante un’operazione in corso.

encode(in, out, endOfInput) fa avanzare le posizioni dei buffer e restituisce CoderResult. In caso di OVERFLOW, preleva i byte; in caso di UNDERFLOW, conserva i caratteri non consumati prima di aggiungerne altri. Inizia una nuova operazione con reset() (non serve al primo utilizzo); termina la codifica con endOfInput = true, quindi chiama flush(out) finché non viene restituito UNDERFLOW.

Il valore predefinito REPORT distingue UTF-16 malformato dai caratteri validi non rappresentabili nel set di caratteri. La variante con un solo buffer genera CharacterCodingException; quella in streaming restituisce un risultato di errore. IGNORE e REPLACE possono causare perdita di informazioni. Non condividere un encoder tra thread in esecuzione contemporanea.

Esempi

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);
        }
    }
}

Risultato

65
226
130
172

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti