Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

CharsetEncoder — kodowanie znaków na bajty

CharsetEncoder zamienia znaki Unicode na bajty wybranego kodowania. Pozwala jawnie obsługiwać błędne dane oraz kodować cały bufor albo kolejne porcje tekstu.

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

Składnia

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 koduje znaki na bajty; CharsetDecoder działa odwrotnie. Utwórz koder przez charset.newEncoder(), wybierając kodowanie jawnie.

CharsetEncoder.encode(CharBuffer) wykonuje reset, kodowanie i końcowe opróżnienie stanu. Zwraca nowy ByteBuffer gotowy do odczytu: pozycja wynosi zero, a limit wskazuje koniec danych. Nie wywołuj tej metody podczas trwającej operacji.

encode(in, out, endOfInput) przesuwa pozycje buforów i zwraca CoderResult. Przy OVERFLOW odbierz bajty; przy UNDERFLOW zachowaj niezużyte znaki przed dołączeniem kolejnych. Nową operację zacznij od reset() (zbędne przy pierwszym użyciu); zakończ kodowanie z endOfInput = true, następnie wywołuj flush(out) aż do UNDERFLOW.

Domyślne REPORT rozróżnia niepoprawny UTF-16 i poprawne znaki niereprezentowalne w danym kodowaniu. Wariant jednobuforowy zgłasza CharacterCodingException, a strumieniowy zwraca wynik błędu. IGNORE i REPLACE mogą utracić informacje. Nie współdziel kodera między równocześnie działającymi wątkami.

Przykłady

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

Wynik

65
226
130
172

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła