compact1, compact2, compact3

java.nio.charset

Класс CoderResult

java.lang. Объект

java.nio.charset. CoderResult

public class CoderResult
extends Object

Описание состояния результата кодера.

Кодер набора символов, то есть, или декодер или кодер, использует байты (или символы) от входного буфера, преобразовывает их, и пишет получающиеся символы (или байты) к буферу вывода. Процесс кодирования завершается для одной из четырех категорий причин, которые описываются экземплярами этого class:

• О потере значимости сообщают, когда есть более ввод, который будет обработан, или есть недостаточный ввод, и дополнительный ввод требуется. Это условие представляется уникальным объектом результата UNDERFLOW, чей isUnderflow метод возвращает true.

• О переполнении сообщают, когда есть недостаточная комната, остающаяся в буфере вывода. Это условие представляется уникальным объектом результата OVERFLOW, чей isOverflow метод возвращает true.

• Об ошибке уродливого ввода сообщают, когда последовательность входных модулей не правильно построена. Такие ошибки описываются экземплярами этого class чей isMalformed метод возвращает true и чей length метод возвращает длину уродливой последовательности. Есть один уникальный экземпляр этого class для всех ошибок уродливого ввода данной длины.

• О неотображаемо-символьной ошибке сообщают, когда последовательность входных модулей обозначает символ, который не может быть представлен в выходном наборе символов. Такие ошибки описываются экземплярами этого class чей isUnmappable метод возвращает true и чей length метод возвращает длину входной последовательности, обозначающей неотображаемый символ. Есть один уникальный экземпляр этого class для всех неотображаемо-символьных ошибок данной длины.

Для удобства, isError метод возвращает true для объектов результата, которые описывают уродливый ввод и неотображаемо-символьные ошибки, но false для тех, которые описывают условия переполнения или потеря значимости.

С тех пор:

1.4

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static CoderResult	ПЕРЕПОЛНЕНИЕ Указание объекта результата на переполнение, означая, что есть недостаточная комната в буфере вывода.
static CoderResult	ПОТЕРЯ ЗНАЧИМОСТИ Указание объекта результата на потерю значимости, означая, что или входной буфер был полностью использован или, если входной буфер еще не пуст, что дополнительный ввод требуется.

Сводка метода

Модификатор и Тип	Метод и Описание
boolean	isError() Говорит, описывает ли этот объект состояние ошибки.
boolean	isMalformed() Говорит, описывает ли этот объект ошибку уродливого ввода.
boolean	isOverflow() Говорит, описывает ли этот объект условие переполнения.
boolean	isUnderflow() Говорит, описывает ли этот объект условие потери значимости.
boolean	isUnmappable() Говорит, описывает ли этот объект неотображаемо-символьную ошибку.
int	length() Возвращает продолжительность ошибочного ввода, описанного этим объектом (дополнительная работа).
static CoderResult	malformedForLength(int length) Статический метод фабрики, который возвращает уникальный объект, описывающий ошибку уродливого ввода данной длины.
void	throwException() Выдает исключение, соответствующее результату, описанному этим объектом.
Строка	toString() Возвращает строку, описывающую этот результат кодера.
static CoderResult	unmappableForLength(int length) Статический метод фабрики, который возвращает уникальный объект результата описание неотображаемо-символьной ошибки данной длины.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

ПОТЕРЯ ЗНАЧИМОСТИ

public static final CoderResult UNDERFLOW

Указание объекта результата на потерю значимости, означая, что или входной буфер был полностью использован или, если входной буфер еще не пуст, что дополнительный ввод требуется.

ПЕРЕПОЛНЕНИЕ

public static final CoderResult OVERFLOW

Указание объекта результата на переполнение, означая, что есть недостаточная комната в буфере вывода.

Деталь метода

toString

public String toString()

Возвращает строку, описывающую этот результат кодера.

Переопределения:

toString в class Object

Возвраты:

Дескриптивная строка

isUnderflow

public boolean isUnderflow()

Говорит, описывает ли этот объект условие потери значимости.

Возвраты:

true, если, и только если, этот объект обозначает потерю значимости

isOverflow

public boolean isOverflow()

Говорит, описывает ли этот объект условие переполнения.

Возвраты:

true, если, и только если, этот объект обозначает переполнение

isError

public boolean isError()

Говорит, описывает ли этот объект состояние ошибки.

Возвраты:

true, если, и только если, этот объект обозначает или ошибку уродливого ввода или неотображаемо-символьную ошибку

isMalformed

public boolean isMalformed()

Говорит, описывает ли этот объект ошибку уродливого ввода.

Возвраты:

true, если, и только если, этот объект обозначает ошибку уродливого ввода

isUnmappable

public boolean isUnmappable()

Говорит, описывает ли этот объект неотображаемо-символьную ошибку.

Возвраты:

true, если, и только если, этот объект обозначает неотображаемо-символьную ошибку

длина

public int length()

Возвращает продолжительность ошибочного ввода, описанного этим объектом (дополнительная работа).

Возвраты:

Продолжительность ошибочного ввода, положительного целого числа

Броски:

UnsupportedOperationException - Если этот объект не описывает состояние ошибки, то есть, если isError не возвращает true

malformedForLength

public static CoderResult malformedForLength(int length)

Статический метод фабрики, который возвращает уникальный объект, описывающий ошибку уродливого ввода данной длины.

Возвраты:

Требуемый объект результата кодера

unmappableForLength

public static CoderResult unmappableForLength(int length)

Статический метод фабрики, который возвращает уникальный объект результата описание неотображаемо-символьной ошибки данной длины.

Возвраты:

Требуемый объект результата кодера

throwException

public void throwException()
                    throws CharacterCodingException

Выдает исключение, соответствующее результату, описанному этим объектом.

Броски:

BufferUnderflowException - Если этот объект является UNDERFLOW

BufferOverflowException - Если этот объект является OVERFLOW

MalformedInputException - Если этот объект представляет ошибку уродливого ввода; значение длины исключения будет значением этого объекта

UnmappableCharacterException - Если этот объект представляет неотображаемо-символьную ошибку; значение длины исключений будет значением этого объекта

CharacterCodingException