CKTIS / Java
CharsetEncoder — kodiranje znakov v bajte
CharsetEncoder pretvarja znake Unicode v bajte izbranega nabora znakov. Omogoča izrecno obravnavo napak ter kodiranje celotnega medpomnilnika ali zaporednih delov besedila.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);CharsetEncoder iz java.nio.charset kodira znake v bajte; CharsetDecoder izvaja obratno operacijo. Ustvarite kodirnik z charset.newEncoder() in izrecno izberite nabor znakov.
CharsetEncoder.encode(CharBuffer) izvede ponastavitev, kodiranje in končno praznjenje stanja. Vrne nov ByteBuffer, pripravljen za branje: njegov položaj je nič, omejitev pa označuje konec podatkov. Te metode ne kličite med potekajočo operacijo.
encode(in, out, endOfInput) premakne položaje medpomnilnikov in vrne CoderResult. Pri OVERFLOW prevzemite bajte; pri UNDERFLOW ohranite neporabljene znake, preden dodate nove. Novo operacijo začnite z reset() (pri prvi uporabi to ni potrebno); kodiranje končajte z endOfInput = true, nato pa kličite flush(out), dokler ne vrne UNDERFLOW.
Privzeti REPORT razlikuje med nepravilnim UTF-16 in veljavnimi znaki, ki jih v naboru znakov ni mogoče predstaviti. Različica z enim medpomnilnikom sproži CharacterCodingException; pretočna različica vrne rezultat napake. IGNORE in REPLACE lahko povzročita izgubo informacij. Kodirnika ne delite med sočasno delujoče niti.
Primeri
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);
}
}
}Rezultat
65 226 130 172
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.