java.io
클래스 InputStreamReader

java.lang.Object 
  |
  +--java.io.Reader 
        |
        +--java.io.InputStreamReader

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

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 () 스트림을 닫습니다.
String	getEncoding () 이 스트림으로 사용되는 캐릭터 인코딩의 이름을 돌려줍니다.
int	read () 단일의 캐릭터를 읽어들입니다.
int	read (char[] cbuf, int offset, int length) 배열의 일부에 캐릭터를 읽어들입니다.
boolean	ready () 스트림이 읽어들여 가능한 상태인가 어떤가를 통지합니다.

클래스 java.io. Reader 에서 상속받은 메소드

mark , markSupported , 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 - 캐릭터 인코딩

도입된 버젼:

1.4

InputStreamReader

public InputStreamReader(InputStream  in,
                         CharsetDecoder  dec)

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

파라미터:

in - InputStream

dec - 캐릭터 인코딩 디코더

도입된 버젼:

1.4

메소드의 상세

getEncoding

public String  getEncoding()

이 스트림으로 사용되는 캐릭터 인코딩의 이름을 돌려줍니다.

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

이 인스턴스가 InputStreamReader(InputStream, String) constructor를 사용해 작성되고 있는 경우, 그 constructor로 건네진 이름은 아니고, 인코딩의 일의명이 돌려주어집니다. 이 메소드는 스트림이 닫고 있는 경우,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 내의 close

예외:

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