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 () 스트림을 닫습니다.
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 

스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Reader 내의 close

예외:

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