Пакет java.nio.charset

package java.nio.charset

Определяет наборы символов, декодеры и кодеры для преобразования между байтами и символами Юникода.

Сводка наборов символов, декодеров и кодеров в этом пакете
Имя класса	Описание
`Charset`	Названное отображение между символами и байтами
`CharsetDecoder`	Декодирует байты в символы
`CharsetEncoder`	Кодирует символы в байты
`CoderResult`	Описывает результаты кодирования
`CodingErrorAction`	Описывает действия, которые необходимо выполнить при обнаружении ошибок кодирования

Набор символов — это именованное отображение последовательностей символов Юникода длиной в шестнадцать бит на последовательности байтов, в том смысле, который определён в RFC 2278. Декодер — это механизм, преобразующий байты в заданном наборе символов в символы, а кодер — механизм, преобразующий символы в байты. Кодеры и декодеры работают с буферами байтов и символов. Они вместе называются кодировщиками.

Класс Charset определяет методы для создания кодеров для заданного набора символов и для извлечения различных имён, связанных с набором символов. Он также определяет статические методы для проверки поддержки конкретного набора символов, для поиска экземпляров наборов символов по имени и для построения карты, содержащей все наборы символов, которые поддерживаются в текущей виртуальной машине Java.

Большинство пользователей не будут использовать эти классы напрямую; вместо этого они будут использовать существующие конструкторы и методы, связанные с набором символов, в классе String, а также существующие классы InputStreamReader и OutputStreamWriter, все реализации которых были переработаны для использования средств набора символов, определённых в этом пакете. Было внесено небольшое количество изменений в классы InputStreamReader и OutputStreamWriter для возможности явного указания объектов наборов символов при создании экземпляров этих классов.

Поддержка новых наборов символов может быть реализована через интерфейс, определённый в классе CharsetProvider в пакете java.nio.charset.spi.

Если не указано иное, передача null аргумента конструктору или методу любого класса или интерфейса в этом пакете приведёт к исключению NullPointerException.

Since:: 1.4

Пакет	Описание
java.nio	Определяет буферы, которые являются контейнерами для данных, и предоставляет обзор других пакетов NIO.
java.nio.charset.spi	Классы поставщиков услуг для пакета `java.nio.charset`.
java.nio.channels	Определяет каналы, которые представляют соединения с сущностями, способными выполнять операции ввода-вывода, такие как файлы и сокеты; определяет селекторы для многоканальных, неблокирующих операций ввода-вывода.
java.nio.file	Определяет интерфейсы и классы для доступа виртуальной машины Java к файлам, атрибутам файлов и файловым системам.

Класс	Описание
CharacterCodingException	Проверяемое исключение, выбрасываемое при возникновении ошибки кодирования или декодирования символов.
Charset	Названное отображение последовательностей шестнадцатибитных единиц кода Юникода кода и последовательностей байтов.
CharsetDecoder	Механизм, который может преобразовать последовательность байтов в заданном наборе символов в последовательность шестнадцатибитных символов Юникода.
CharsetEncoder	Механизм, который может преобразовать последовательность шестнадцатибитных символов Юникода в последовательность байтов в заданном наборе символов.
CoderMalfunctionError	Ошибка, выбрасываемая, когда метод `decodeLoop` в `CharsetDecoder` или метод `encodeLoop` в `CharsetEncoder` выбрасывает непредвиденное исключение.
CoderResult	Описание состояния результата кодирования.
CodingErrorAction	Тип enumeration для действий при возникновении ошибок кодирования.
IllegalCharsetNameException	Исключение, выбрасываемое, когда строка, которая не является допустимым именем набора символов, используется как таковая.
MalformedInputException	Проверяемое исключение, выбрасываемое, когда последовательность входных байтов не является допустимой для заданного набора символов или последовательность входных символов не является допустимой последовательностью шестнадцатибитных символов Юникода.
StandardCharsets	Постоянные определения для стандартных `charsets`.
UnmappableCharacterException	Проверяемое исключение, выбрасываемое, когда последовательность входных символов (или байтов) является допустимой, но не может быть отображена в последовательность выходных байтов (или символов).
UnsupportedCharsetException	Непроверяемое исключение, выбрасываемое, когда поддержка для запрошенного набора символов отсутствует.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/charset/package-summary.html