java.io
클래스 InputStreamReader

java.lang.Object 
  java.io.Reader 
      java.io.InputStreamReader

모든 구현된 인터페이스:

Closeable , Readable

직계의 기존의 서브 클래스:

FileReader

public class InputStreamReader
extends Reader 

InputStreamReader 는 바이트 스트림로부터 문자 스트림에의 중개의 역할을 가집니다. 바이트를 읽어들여, 지정된 charset 를 사용해 문자로 변환합니다. 사용되는 캐릭터 세트는, 이름으로 지정하는 일도, 명시적으로 건네주는 일도, 또는 플랫폼의 디폴트의 캐릭터 세트를 그대로 사용할 수도 있습니다.

InputStreamReader 의 read() 메소드의 어느쪽이든을 호출할 때마다, 기본이 되는 바이트 입력 스트림로부터 1 개 이상의 바이트가 읽힙니다. 바이트로부터 문자에의 효율적인 변환을 가능하게 하기 위해서, 현재의 read 오퍼레이션을 채우는데 필요한 양보다 많은 바이트를 기본이 되는 스트림로부터 예측할 수가 있습니다.

변환 효율을 최고로 하려면 , BufferedReader 의 내부에 InputStreamReader 를 랩 하는 것을 고려해 주세요. 다음에 예를 나타냅니다.

BufferedReader in
= new BufferedReader(new InputStreamReader(System.in));
 

도입된 버젼:

JDK1. 1

관련 항목:

BufferedReader , InputStream , Charset

필드의 개요

클래스 java.io. Reader 로부터 상속된 필드

lock

생성자 의 개요

InputStreamReader (InputStream in)
디폴트의 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

InputStreamReader (InputStream in, Charset cs)
주어진 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

InputStreamReader (InputStream in, CharsetDecoder dec)
주어진 캐릭터 세트 디코더를 사용하는 InputStreamReader 를 작성합니다.

InputStreamReader (InputStream in, String charsetName)
지정된 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

메소드의 개요

void	close () 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
String	getEncoding () 이 스트림로 사용되는 문자 인코딩의 이름을 돌려줍니다.
int	read () 단일의 문자를 읽어들입니다.
int	read (char[] cbuf, int offset, int length) 배열의 일부에 문자를 읽어들입니다.
boolean	ready () 이 스트림이 읽어들여 가능한가 어떤가를 판정합니다.

클래스 java.io. Reader 로부터 상속된 메소드

mark , markSupported , read , read , reset , skip

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

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

생성자 의 상세

InputStreamReader

public InputStreamReader(InputStream  in)

디폴트의 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

파라미터:

in - InputStream

InputStreamReader

public InputStreamReader(InputStream  in,
                         String  charsetName)
                  throws UnsupportedEncodingException 

지정된 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

파라미터:

in - InputStream

charsetName - 지원하는 charset 의 이름

예외:

UnsupportedEncodingException - 지정된 캐릭터 세트가 지원되어 있지 않은 경우

InputStreamReader

public InputStreamReader(InputStream  in,
                         Charset  cs)

주어진 캐릭터 세트를 사용하는 InputStreamReader 를 작성합니다.

파라미터:

in - InputStream

cs - charset

도입된 버젼:

1.4

InputStreamReader

public InputStreamReader(InputStream  in,
                         CharsetDecoder  dec)

주어진 캐릭터 세트 디코더를 사용하는 InputStreamReader 를 작성합니다.

파라미터:

in - InputStream

dec - 캐릭터 세트 디코더

도입된 버젼:

1.4

메소드의 상세

getEncoding

public String  getEncoding()

이 스트림로 사용되는 문자 인코딩의 이름을 돌려줍니다.

인코딩에 호환명이 있는 경우는, 그 이름을 돌려줍니다. 호환명이 없는 경우는, 인코딩의 정규명을 돌려줍니다.

이 인스턴스가 InputStreamReader(InputStream, String) 생성자 을 사용해 작성되었을 경우, 생성자 에게 건네진 이름은 아니고, 인코딩에 대해서 일의가 되는 이름이 돌려주어집니다. 스트림이 닫고 있는 경우, 이 메소드는 null 를 돌려줍니다.

반환값:

이 인코딩의 호환명. 스트림이 닫고 있는 경우는 null

관련 항목:

Charset

read

public int read()
         throws IOException 

단일의 문자를 읽어들입니다.

오버라이드(override):

클래스 Reader 내의 read

반환값:

읽힌 문자. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

read

public int read(char[] cbuf,
                int offset,
                int length)
         throws IOException 

배열의 일부에 문자를 읽어들입니다.

정의:

클래스 Reader 내의 read

파라미터:

cbuf - 전송처 버퍼

offset - 문자의 포함 개시 오프셋(offset)

length - 읽어들이는 문자의 최대수

반환값:

읽힌 문자수. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

ready

public boolean ready()
              throws IOException 

이 스트림이 읽어들여 가능한가 어떤가를 판정합니다. InputStreamReader 는, 입력 버퍼가 공백이 아닌 경우, 또는 기본이 되는 바이트 스트림로부터 바이트 데이터를 읽어들일 수 있는 상태인 경우에 읽어들여 가능합니다.

오버라이드(override):

클래스 Reader 내의 ready

반환값:

다음의 read()가 입력을 블록 하지 않는 것이 확실한 경우는 true, 그렇지 않은 경우는 false. false 가 돌려주어져도, 다음의 read가 확실히 블록 한다는 것이 아니다

예외:

IOException - 입출력 에러가 발생했을 경우

close

public void close()
           throws IOException 

클래스 Reader 의 기술:

스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다. 스트림이 닫혀진 뒤에 read(), ready(), mark(), reset(), 또는 skip()를 호출하면(자), IOException 가 throw 됩니다. 벌써 닫혀지고 있는 스트림을 닫아도, 무슨 영향도 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Reader 내의 close

예외:

IOException - 입출력 에러가 발생했을 경우