Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri