Spec-Zone.ru › OpenJDK 25

Пакет java.nio.charset

package java.nio.charset
Определяет наборы символов, декодеры и кодировщики для преобразования байтов в символы Unicode и обратно.
Краткое описание наборов символов, декодеров и кодировщиков в этом пакете
Имя класса Описание
Charset Именованное соответствие между символами и байтами
CharsetDecoder Декодирует байты в символы
CharsetEncoder Кодирует символы в байты
CoderResult Описывает результаты кодирования
CodingErrorAction Описывает действия, выполняемые при обнаружении ошибок кодирования

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

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

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

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

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

Начиная с:
1.4
Внешние спецификации
  • RFC 2278: Процедуры регистрации наборов символов IANA
Пакет Описание
java.nio
Определяет буферы, которые являются контейнерами данных, и содержит обзор других пакетов NIO.
java.nio.charset.spi
Классы поставщиков служб для пакета java.nio.charset.
java.nio.channels
Определяет каналы, представляющие соединения с объектами, способными выполнять операции ввода-вывода, такими как файлы и сокеты; определяет селекторы для мультиплексированных неблокирующих операций ввода-вывода.
java.nio.file
Определяет интерфейсы и классы, с помощью которых виртуальная машина Java получает доступ к файлам, атрибутам файлов и файловым системам.
Класс Описание
CharacterCodingException
Проверяемое исключение, выбрасываемое при возникновении ошибки кодирования или декодирования символов.
Charset
Именованное соответствие между последовательностями кодовых единиц Unicode шириной шестнадцать бит и последовательностями байтов.
CharsetDecoder
Механизм, преобразующий последовательность байтов в заданном наборе символов в последовательность шестнадцатибитных символов Unicode.
CharsetEncoder
Механизм, преобразующий последовательность шестнадцатибитных символов Unicode в последовательность байтов в заданном наборе символов.
CoderMalfunctionError
Ошибка, выбрасываемая, если метод decodeLoop класса CharsetDecoder или метод encodeLoop класса CharsetEncoder выбрасывает непредвиденное исключение.
CoderResult
Описание состояния результата кодировщика.
CodingErrorAction
Типобезопасное перечисление действий при ошибках кодирования.
IllegalCharsetNameException
Непроверяемое исключение, выбрасываемое, если строка, не являющаяся допустимым именем набора символов, используется в качестве таковой.
MalformedInputException
Проверяемое исключение, выбрасываемое, если входная последовательность байтов недопустима для заданного набора символов или входная последовательность символов не является допустимой последовательностью шестнадцатибитных символов Unicode.
StandardCharsets
Определения констант для стандартных charsets.
UnmappableCharacterException
Проверяемое исключение, выбрасываемое, если входная последовательность символов (или байтов) допустима, но не может быть преобразована в выходную последовательность байтов (или символов).
UnsupportedCharsetException
Непроверяемое исключение, выбрасываемое, если запрошенный набор символов не поддерживается.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, в том числе концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/nio/charset/package-summary.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API