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.