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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.