CKTIS / Java
CharsetEncoder – Zeichen in Bytes kodieren
CharsetEncoder wandelt Unicode-Zeichen in Bytes eines ausgewählten Zeichensatzes um. Er ermöglicht eine explizite Fehlerbehandlung und die Kodierung eines ganzen Puffers oder aufeinanderfolgender Textabschnitte.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);CharsetEncoder aus java.nio.charset kodiert Zeichen in Bytes; CharsetDecoder führt den umgekehrten Vorgang aus. Erstellen Sie einen Encoder mit charset.newEncoder() und wählen Sie den Zeichensatz ausdrücklich aus.
CharsetEncoder.encode(CharBuffer) führt Zurücksetzen, Kodierung und abschließendes Leeren des Zustands aus. Die Methode gibt einen neuen, lesebereiten ByteBuffer zurück: Seine Position ist null, und sein Limit markiert das Datenende. Rufen Sie diese Methode nicht während eines laufenden Vorgangs auf.
encode(in, out, endOfInput) verschiebt die Pufferpositionen und gibt CoderResult zurück. Bei OVERFLOW lesen Sie die Bytes aus; bei UNDERFLOW bewahren Sie nicht verbrauchte Zeichen auf, bevor Sie weitere hinzufügen. Beginnen Sie einen neuen Vorgang mit reset() (bei der ersten Verwendung nicht nötig); beenden Sie die Kodierung mit endOfInput = true und rufen Sie dann flush(out) auf, bis UNDERFLOW zurückgegeben wird.
Das standardmäßige REPORT unterscheidet fehlerhaftes UTF-16 von gültigen Zeichen, die im Zeichensatz nicht darstellbar sind. Die Variante mit einem Puffer löst CharacterCodingException aus; die Streaming-Variante gibt ein Fehlerergebnis zurück. IGNORE und REPLACE können Informationen verlieren lassen. Teilen Sie einen Encoder nicht zwischen gleichzeitig laufenden Threads.
Beispiele
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);
}
}
}Ergebnis
65 226 130 172
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.