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 개로 나타내집니다.

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

편의상,isError 메소드는 부정 입력 에러나 MAP 불가 캐릭터 에러를 나타내는 결과 오브젝트에 대해서는 true, 언더 플로우(underflow) 조건이나 오버플로우 조건을 나타내는 결과 오브젝트에 대해서는 false 를 돌려줍니다.

도입된 버젼:

1.4

필드의 개요

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

메소드의 개요

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

클래스 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()

이 오브젝트가 에러 조건을 나타내고 있는지 어떤지를 판단합니다.

반환값:

이 오브젝트가 부정 입력 에러 또는 MAP 불가 캐릭터 에러를 나타내고 있는 경우에 한해 true

isMalformed

public boolean isMalformed()

이 오브젝트가 부정 입력 에러를 나타내고 있는지 어떤지를 판단합니다.

반환값:

이 오브젝트가 부정 입력 에러를 나타내고 있는 경우에 한해 true

isUnmappable

public boolean isUnmappable()

이 오브젝트가 MAP 불가 캐릭터 에러를 나타내고 있는지 어떤지를 판단합니다.

반환값:

이 오브젝트가 MAP 불가 캐릭터 에러를 나타내고 있는 경우에 한해 true

length

public int length()

이 오브젝트에 의해 나타나는 에러 입력의 길이를 돌려줍니다 (옵션).

반환값:

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

예외:

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

malformedForLength

public static CoderResult  malformedForLength(int length)

지정된 길이의 부정 입력 에러를 나타내는 일의의 오브젝트를 돌려주는 정적 팩토리 메소드입니다.

반환값:

요구된 Coder Result 오브젝트

unmappableForLength

public static CoderResult  unmappableForLength(int length)

지정된 길이의 MAP 불가 캐릭터 에러를 나타내는 일의의 오브젝트를 돌려주는 정적 팩토리 메소드입니다.

반환값:

요구된 Coder Result 오브젝트

throwException

public void throwException()
                    throws CharacterCodingException 

이 오브젝트가 가리키는 결과에 응해 예외를 슬로우 합니다.

예외:

BufferUnderflowException - 이 오브젝트가 UNDERFLOW 인 경우

BufferOverflowException - 이 오브젝트가 OVERFLOW 인 경우

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

UnmappableCharacterException - 이 오브젝트가 MAP 불가 캐릭터 에러를 나타내는 경우, 예외의 길이의 값은 이 오브젝트의 길이와 같게 된다

CharacterCodingException