Spec-Zone.ru › OpenJDK 24

Пакет java.nio.charset

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

Набор символов — это именованное отображение между последовательностями символов Юникода с 16-разрядной кодировкой и последовательностями байтов, в соответствии с определением в RFC 2278. Декодер — это механизм, который преобразует байты в символы определенного набора символов, а кодер — механизм, который преобразует символы в байты. Кодеры и декодеры работают с буферами байтов и символов. В совокупности они называются кодерами.

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

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

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

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

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

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

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/charset/package-summary.html

Spec-Zone.ru

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