Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CharsetEncoder — kódování znaků do bajtů

CharsetEncoder převádí znaky Unicode na bajty ve zvolené znakové sadě. Umožňuje explicitně řešit chyby a kódovat celý buffer nebo postupné části textu.

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

Syntaxe

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

CharsetEncoder z java.nio.charset kóduje znaky do bajtů; CharsetDecoder provádí opačnou operaci. Vytvořte kodér pomocí charset.newEncoder() a znakovou sadu zvolte výslovně.

CharsetEncoder.encode(CharBuffer) provede reset, kódování a závěrečné vyprázdnění stavu. Vrátí nový ByteBuffer připravený ke čtení: jeho pozice je nula a limit označuje konec dat. Tuto metodu nevolejte během probíhající operace.

encode(in, out, endOfInput) posouvá pozice bufferů a vrací CoderResult. Při OVERFLOW odeberte bajty; při UNDERFLOW zachovejte nespotřebované znaky, než přidáte další. Novou operaci zahajte pomocí reset() (při prvním použití není třeba); kódování ukončete nastavením endOfInput = true a potom volejte flush(out), dokud nevrátí UNDERFLOW.

Výchozí REPORT rozlišuje chybné UTF-16 od platných znaků, které nelze ve znakové sadě reprezentovat. Varianta s jedním bufferem vyvolá CharacterCodingException; streamovací varianta vrátí chybový výsledek. IGNORE a REPLACE mohou způsobit ztrátu informací. Nesdílejte kodér mezi současně běžícími vlákny.

Příklady

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

Výsledek

65
226
130
172

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje