KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CharsetEncoder — tekens naar bytes coderen

CharsetEncoder zet Unicode-tekens om in bytes met een geselecteerde tekenset. Hiermee kunt u fouten expliciet afhandelen en een volledige buffer of opeenvolgende stukken tekst coderen.

Versie: 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 uit java.nio.charset codeert tekens naar bytes; CharsetDecoder doet het omgekeerde. Maak een encoder met charset.newEncoder() en kies de tekenset expliciet.

CharsetEncoder.encode(CharBuffer) voert een reset, de codering en het definitief leegmaken van de status uit. De methode retourneert een nieuwe ByteBuffer die klaar is om te lezen: de positie is nul en de limiet markeert het einde van de gegevens. Roep deze methode niet aan tijdens een lopende bewerking.

encode(in, out, endOfInput) verplaatst de bufferposities en retourneert CoderResult. Haal bij OVERFLOW de bytes op; bewaar bij UNDERFLOW de niet-verbruikte tekens voordat u meer toevoegt. Begin een nieuwe bewerking met reset() (niet nodig bij het eerste gebruik); beëindig de codering met endOfInput = true en roep daarna flush(out) aan totdat UNDERFLOW wordt geretourneerd.

De standaardinstelling REPORT maakt onderscheid tussen ongeldige UTF-16 en geldige tekens die niet in de tekenset kunnen worden weergegeven. De variant met één buffer werpt CharacterCodingException; de streamingvariant retourneert een foutresultaat. IGNORE en REPLACE kunnen informatieverlies veroorzaken. Deel een encoder niet tussen threads die gelijktijdig actief zijn.

Voorbeelden

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

Resultaat

65
226
130
172

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen