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.