java.nio.charset
클래스 CoderResult

java.lang.Object 
  java.nio.charset.CoderResult

public class CoderResult
extends Object 

코다의 결과 상태의 설명입니다.

캐릭터셋의 코다 (디코더 또는 엔코더)는 입력 버퍼내의 바이트 또는 문자를 소비해, 변환해, 생성된 문자 또는 바이트를 출력 버퍼에 출력합니다. 코딩 프로세스는 다음의 4개의 카테고리의 어느쪽이든으로 종료합니다. 덧붙여 이것들은 이 클래스의 인스턴스에 의해 나타내집니다.

• 「언더 플로우(underflow)」. 처리하는 입력이 더 이상 없어졌을 경우, 또는 입력 내용이 불완전해 추가 입력이 필요한 경우에 보고됩니다. 이 조건은 일의의 결과 객체 UNDERFLOW isUnderflow 메서드가 true를 돌려주는 것에 의해 나타내집니다.

• 「오버플로우」. 출력 버퍼의 용량이 부족했을 때에 보고됩니다. 이 조건은 일의의 결과 객체 OVERFLOW isOverflow 메서드가 true를 돌려주는 것에 의해 나타내집니다.

• 「부정 입력 에러」. 입력 유니트의 순서가 부정한 경우에 보고됩니다. 이러한 에러는 이 클래스의 인스턴스의 isMalformed 메서드가 true를 돌려주는 것에 의해 나타내져length 메서드는 부정한 순서의 길이를 리턴합니다. 특정의 길이의 부정 입력 에러는 모두, 이 클래스의 일의의 인스턴스 1개 로 나타내집니다.

• 「맵 불가 문자 에러」. 입력 유니트의 순서가 출력 캐릭터셋로 표현할 수 없는 문자일 때 보고됩니다. 이러한 에러는 이 클래스의 인스턴스의 isUnmappable 메서드가 true를 돌려주는 것에 의해 나타내져length 메서드는 맵 불가 문자가 있는 입력 순서의 길이를 리턴합니다. 특정의 길이의 맵 불가 문자 에러는 모두, 이 클래스의 일의의 인스턴스 1개 로 나타내집니다.

편의상, isError 메서드는 부정 입력 에러나 맵 불가 문자 에러를 나타내는 결과 객체에 대해서는 true, 언더 플로우(underflow) 조건이나 오버플로우 조건을 나타내는 결과 객체에 대해서는 false를 리턴합니다.

도입된 버전 :

1.4

필드 개요

static CoderResult	OVERFLOW 오버플로우를 나타내는 결과 객체로 출력 버퍼의 용량이 부족한 상태를 나타냅니다.
static CoderResult	UNDERFLOW 언더 플로우(underflow)를 나타내는 결과 객체로 입력 버퍼가 완전하게 소비된 상태인가 입력 버퍼가 아직 비어있지 않은 경우는 추가 입력이 필요한 상태를 나타냅니다.

메서드 개요

boolean	isError () 이 객체가 에러 조건을 나타내고 있는지를 판단합니다.
boolean	isMalformed () 이 객체가 부정 입력 에러를 나타내고 있는지를 판단합니다.
boolean	isOverflow () 이 객체가 오버플로우 조건을 나타내고 있는지를 판단합니다.
boolean	isUnderflow () 이 객체가 언더 플로우(underflow) 조건을 나타내고 있는지를 판단합니다.
boolean	isUnmappable () 이 객체가 맵 불가 문자 에러를 나타내고 있는지를 판단합니다.
int	length () 이 객체에 의해 나타내지고 있는 에러 입력의 길이를 리턴합니다 (옵션).
static CoderResult	malformedForLength (int length) 지정된 길이의 부정 입력 에러를 나타낸 일의의 객체를 돌려주는 static 팩토리 메서드입니다.
void	throwException () 이 객체가 가리키는 결과에 응해 예외를 Throw 합니다.
String	toString () 이 코다의 결과를 설명하는 캐릭터 라인을 리턴합니다.
static CoderResult	unmappableForLength (int length) 지정된 길이의 맵 불가 문자 에러를 나타낸 일의의 객체를 돌려주는 static 팩토리 메서드입니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

UNDERFLOW

public static final CoderResult  UNDERFLOW

언더 플로우(underflow)를 나타내는 결과 객체로 입력 버퍼가 완전하게 소비된 상태인가 입력 버퍼가 아직 비어있지 않은 경우는 추가 입력이 필요한 상태를 나타냅니다.

OVERFLOW

public static final CoderResult  OVERFLOW

오버플로우를 나타내는 결과 객체로 출력 버퍼의 용량이 부족한 상태를 나타냅니다.

메서드의 상세

toString

public String  toString()

이 코다의 결과를 설명하는 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

설명문자열

isUnderflow

public boolean isUnderflow()

이 객체가 언더 플로우(underflow) 조건을 나타내고 있는지를 판단합니다.

반환값:

이 객체가 언더 플로우(underflow) 조건을 나타내고 있는 경우에 한정해 true

isOverflow

public boolean isOverflow()

이 객체가 오버플로우 조건을 나타내고 있는지를 판단합니다.

반환값:

이 객체가 오버플로우 조건을 나타내고 있는 경우에 한정해 true

isError

public boolean isError()

이 객체가 에러 조건을 나타내고 있는지를 판단합니다.

반환값:

이 객체가 부정 입력 에러 또는 맵 불가 문자 에러를 나타내고 있는 경우에 한정해 true

isMalformed

public boolean isMalformed()

이 객체가 부정 입력 에러를 나타내고 있는지를 판단합니다.

반환값:

이 객체가 부정 입력 에러를 나타내고 있는 경우에 한정해 true

isUnmappable

public boolean isUnmappable()

이 객체가 맵 불가 문자 에러를 나타내고 있는지를 판단합니다.

반환값:

이 객체가 맵 불가 문자 에러를 나타내고 있는 경우에 한정해 true

length

public int length()

이 객체에 의해 나타내지고 있는 에러 입력의 길이를 리턴합니다 (옵션).

반환값:

에러 입력의 길이 (정의 정수)

예외:

UnsupportedOperationException - 이 객체가 에러 조건을 나타내지 않은 경우, 즉 isError 가 true를 돌려주지 않는 경우

malformedForLength

public static CoderResult  malformedForLength(int length)

지정된 길이의 부정 입력 에러를 나타낸 일의의 객체를 돌려주는 static 팩토리 메서드입니다.

반환값:

요구된 Coder Result 객체

unmappableForLength

public static CoderResult  unmappableForLength(int length)

지정된 길이의 맵 불가 문자 에러를 나타낸 일의의 객체를 돌려주는 static 팩토리 메서드입니다.

반환값:

요구된 Coder Result 객체

throwException

public void throwException()
                    throws CharacterCodingException 

이 객체가 가리키는 결과에 응해 예외를 Throw 합니다.

예외:

BufferUnderflowException - 이 객체가 UNDERFLOW 인 경우

BufferOverflowException - 이 객체가 OVERFLOW 인 경우

MalformedInputException - 이 객체가 부정 입력 에러를 나타내는 경우, 예외의 길이의 값은 이 객체의 길이와 같게 된다

UnmappableCharacterException - 이 객체가 맵 불가 문자 에러를 나타내는 경우, 예외의 길이의 값은 이 객체의 길이와 같게 된다

CharacterCodingException