CKTIS / Java
CharsetEncoder — kodiranje znakova u bajtove
CharsetEncoder pretvara Unicode znakove u bajtove odabranog skupa znakova. Omogućuje izričito rukovanje pogreškama te kodiranje cijelog međuspremnika ili uzastopnih dijelova teksta.
Verzija: 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 znakove u bajtove; CharsetDecoder radi obrnuto. Izradite koder pomoću charset.newEncoder() i izričito odaberite skup znakova.
CharsetEncoder.encode(CharBuffer) izvodi resetiranje, kodiranje i završno pražnjenje stanja. Vraća novi ByteBuffer spreman za čitanje: njegova je pozicija nula, a granica označava kraj podataka. Nemojte pozivati ovu metodu tijekom operacije koja je u tijeku.
encode(in, out, endOfInput) pomiče pozicije međuspremnika i vraća CoderResult. Kod OVERFLOW preuzmite bajtove; kod UNDERFLOW sačuvajte nepotrošene znakove prije dodavanja novih. Novu operaciju započnite s reset() (nije potrebno pri prvoj upotrebi); završite kodiranje postavljanjem endOfInput = true, a zatim pozivajte flush(out) dok ne vrati UNDERFLOW.
Zadani REPORT razlikuje neispravan UTF-16 od valjanih znakova koji se ne mogu prikazati u skupu znakova. Varijanta s jednim međuspremnikom izbacuje CharacterCodingException; varijanta za tok vraća rezultat pogreške. IGNORE i REPLACE mogu uzrokovati gubitak informacija. Nemojte dijeliti koder između istodobno aktivnih dretvi.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.