База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CharsetEncoder — кодиране на знаци в байтове

CharsetEncoder преобразува Unicode знаци в байтове от избран набор от знаци. Позволява изрична обработка на грешки и кодиране на цял буфер или на последователни части от текст.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);

CharsetEncoder от java.nio.charset кодира знаци в байтове; CharsetDecoder извършва обратното. Създайте кодиращ обект чрез charset.newEncoder(), като изберете набора от знаци изрично.

CharsetEncoder.encode(CharBuffer) извършва нулиране, кодиране и окончателно изчистване на състоянието. Връща нов ByteBuffer, готов за четене: позицията му е нула, а лимитът обозначава края на данните. Не извиквайте този метод по време на текуща операция.

encode(in, out, endOfInput) придвижва позициите на буферите и връща CoderResult. При OVERFLOW извлечете байтовете; при UNDERFLOW запазете неизползваните знаци, преди да добавите още. Започнете нова операция с reset() (не е нужно при първата употреба); завършете кодирането с endOfInput = true, след което извиквайте flush(out), докато се върне UNDERFLOW.

Стандартната настройка REPORT различава неправилния UTF-16 от валидните знаци, които не могат да бъдат представени в набора от знаци. Вариантът с един буфер хвърля CharacterCodingException, а потоковият вариант връща резултат за грешка. IGNORE и REPLACE могат да доведат до загуба на информация. Не споделяйте кодиращ обект между нишки, които работят едновременно.

Примери

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

Резултат

65
226
130
172

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници