CoderResult (Платформа Java SE 7)

java.lang. Объект
- java.nio.charset. CoderResult

```
public class CoderResult
extends Object
```
Описание состояния результата кодера.
Кодер набора символов, то есть, или декодер или кодер, использует байты (или символы) от входного буфера, преобразовывает их, и пишет получающиеся символы (или байты) к буферу вывода. Процесс кодирования завершается для одной из четырех категорий причин, которые описываются экземплярами этого класса:
- О потере значимости сообщают, когда есть более ввод, который будет обработан, или есть недостаточный ввод, и дополнительный ввод требуется. Это условие представляется уникальным объектом результата UNDERFLOW, чей isUnderflow метод возвращает true.
- О переполнении сообщают, когда есть недостаточная комната, остающаяся в буфере вывода. Это условие представляется уникальным объектом результата OVERFLOW, чей isOverflow метод возвращает true.
- Об ошибке уродливого ввода сообщают, когда последовательность входных модулей не правильно построена. Такие ошибки описываются экземплярами этого класса чей isMalformed метод возвращает true и чей length метод возвращает длину уродливой последовательности. Есть один уникальный экземпляр этого класса для всех ошибок уродливого ввода данной длины.
- О неотображаемо-символьной ошибке сообщают, когда последовательность входных модулей обозначает символ, который не может быть представлен в выходном наборе символов. Такие ошибки описываются экземплярами этого класса чей isUnmappable метод возвращает true и чей length метод возвращает длину входной последовательности, обозначающей неотображаемый символ. Есть один уникальный экземпляр этого класса для всех неотображаемо-символьных ошибок данной длины.
Для удобства, 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)` Статический метод фабрики, который возвращает уникальный объект результата описание неотображаемо-символьной ошибки данной длины.

Методы 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 в классе 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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс CoderResult

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

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

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

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

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

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

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

toString

isUnderflow

isOverflow

isError

isMalformed

isUnmappable

длина

malformedForLength

unmappableForLength

throwException