CoderResult (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

java.nio.charset
클래스 CoderResult

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

public class CoderResult
extends Object
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)를 나타내는 결과 객체로, 입력 버퍼가 완전하게 소비된 상태인가, 입력 버퍼가 아직 빈 상태(empty)이 아닌 경우는, 추가 입력이 필요한 상태를 나타냅니다.

메소드의 개요
`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)를 나타내는 결과 객체로, 입력 버퍼가 완전하게 소비된 상태인가, 입력 버퍼가 아직 빈 상태(empty)이 아닌 경우는, 추가 입력이 필요한 상태를 나타냅니다.

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

개요