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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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` - 입출력 에러가 발생했을 경우

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.