Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

CharsetEncoder — kódovanie znakov do bajtov

CharsetEncoder prevádza znaky Unicode na bajty vo vybranej znakovej sade. Umožňuje explicitne spracovať chyby a zakódovať celý buffer alebo postupné časti textu.

Verzia: 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 z java.nio.charset kóduje znaky do bajtov; CharsetDecoder vykonáva opačnú operáciu. Vytvorte kodér pomocou charset.newEncoder() a znakovú sadu vyberte výslovne.

CharsetEncoder.encode(CharBuffer) vykoná reset, kódovanie a záverečné vyprázdnenie stavu. Vráti nový ByteBuffer pripravený na čítanie: jeho pozícia je nula a limit označuje koniec údajov. Túto metódu nevolajte počas prebiehajúcej operácie.

encode(in, out, endOfInput) posúva pozície bufferov a vracia CoderResult. Pri OVERFLOW odoberte bajty; pri UNDERFLOW zachovajte nespotrebované znaky pred pridaním ďalších. Novú operáciu začnite pomocou reset() (pri prvom použití to netreba); kódovanie ukončite nastavením endOfInput = true a potom volajte flush(out), kým nevráti UNDERFLOW.

Predvolené REPORT rozlišuje chybné UTF-16 od platných znakov, ktoré sa v znakovej sade nedajú reprezentovať. Variant s jedným bufferom vyhodí CharacterCodingException; streamovací variant vráti chybový výsledok. IGNORE a REPLACE môžu spôsobiť stratu informácií. Nezdieľajte kodér medzi súčasne bežiacimi vláknami.

Prí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ýsledok

65
226
130
172

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje