java.io
클래스 CharArrayReader

java.lang.Object 
  java.io.Reader 
      java.io.CharArrayReader

모든 구현된 인터페이스:

Closeable , Readable

public class CharArrayReader
extends Reader 

문자 입력 스트림로서 사용하는 문자 버퍼를 구현합니다.

도입된 버젼:

JDK1. 1

필드의 개요

protected char[]	buf 문자 버퍼입니다.
protected int	count 이 버퍼의 마지막 인덱스입니다.
protected int	markedPos 버퍼내의 마크 위치입니다.
protected int	pos 현재의 버퍼의 위치입니다.

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

lock

생성자 의 개요

CharArrayReader (char[] buf)
지정된 문자의 배열로부터 CharArrayReader 를 작성합니다.

CharArrayReader (char[] buf, int offset, int length)
지정된 문자의 배열로부터 CharArrayReader 를 작성합니다.

메소드의 개요

void	close () 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
void	mark (int readAheadLimit) 스트림의 현재 위치에 마크를 설정합니다.
boolean	markSupported () 이 스트림이, 실행하는 mark() 조작을 지원할지 어떨지를 통지합니다.
int	read () 단일의 문자를 읽어들입니다.
int	read (char[] b, int off, int len) 배열의 일부에 문자를 읽어들입니다.
boolean	ready () 스트림이 읽어들여 가능한 상태인가 어떤가를 통지합니다.
void	reset () 직전의 마크 위치에 스트림을 리셋 합니다.
long	skip (long n) 문자를 스킵 합니다.

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

read , read

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

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

필드의 상세

buf

protected char[] buf

문자 버퍼입니다.

pos

protected int pos

현재의 버퍼의 위치입니다.

markedPos

protected int markedPos

버퍼내의 마크 위치입니다.

count

protected int count

이 버퍼의 마지막 인덱스입니다. 이 인덱스 이후에 유효한 데이터는 없습니다.

생성자 의 상세

CharArrayReader

public CharArrayReader(char[] buf)

지정된 문자의 배열로부터 CharArrayReader 를 작성합니다.

파라미터:

buf - 입력 버퍼 (카피되어 있지 않다)

CharArrayReader

public CharArrayReader(char[] buf,
                       int offset,
                       int length)

지정된 문자의 배열로부터 CharArrayReader 를 작성합니다.

결과적으로 얻을 수 있는 리더는, 지정된 offset 로부터 read를 개시합니다. 이 리더로부터 읽어낼 수 있는 char 치의 총수는,length 와 buf.length-offset 의 언젠가 작은 (분)편이 됩니다.

파라미터:

buf - 입력 버퍼 (카피되어 있지 않다)

offset - 읽어들이는 최초의 문자 오프셋(offset)

length - 읽어들이는 문자수

예외:

IllegalArgumentException - offset 가 부 또는 buf.length 보다 큰 경우,length 가 부의 경우, 또는 이것들 2 개의 값의 화가 부의 경우

메소드의 상세

read

public int read()
         throws IOException 

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

오버라이드(override):

클래스 Reader 내의 read

반환값:

0 ~ 65535 (0x00-0xffff)의 범위의 정수로서의, 읽힌 문자. 스트림의 마지막에 이르렀을 경우는 -1

예외:

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

read

public int read(char[] b,
                int off,
                int len)
         throws IOException 

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

정의:

클래스 Reader 내의 read

파라미터:

b - 전송처 버퍼

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

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

반환값:

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

예외:

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

skip

public long skip(long n)
          throws IOException 

문자를 스킵 합니다. 스킵 한 문자수를 돌려줍니다.

n 파라미터에는,Reader 슈퍼 클래스의 skip 메소드가 예외를 throw 하는 경우여도, 부를 설정할 수 있습니다. n 가 부의 경우, 이 메소드는 아무것도 하지 않고 0 을 돌려줍니다.

오버라이드(override):

클래스 Reader 내의 skip

파라미터:

n - 스킵 하는 문자수

반환값:

실제로 스킵 한 문자수

예외:

IOException - 스트림이 닫혀지고 있는 경우, 또는 입출력 에러가 발생했을 경우

ready

public boolean ready()
              throws IOException 

스트림이 읽어들여 가능한 상태인가 어떤가를 통지합니다. 문자 배열의 리더는, 항상 읽어들여 가능합니다.

오버라이드(override):

클래스 Reader 내의 ready

반환값:

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

예외:

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

markSupported

public boolean markSupported()

이 스트림이, 실행하는 mark() 조작을 지원할지 어떨지를 통지합니다.

오버라이드(override):

클래스 Reader 내의 markSupported

반환값:

이 스트림이 mark 오퍼레이션을 지원하는 경우에 한정해 true

mark

public void mark(int readAheadLimit)
          throws IOException 

스트림의 현재 위치에 마크를 설정합니다. 이후 reset()를 호출하면(자), 스트림의 위치가 이 정도치로 변경됩니다.

오버라이드(override):

클래스 Reader 내의 mark

파라미터:

readAheadLimit - 마크를 보관 유지하면서 읽어들일 수가 있는 문자수의 상한. 스트림에는 문자 배열로부터 입력되므로, 실제의 상한은 없다. 그 때문에, 이 인수는 무시된다

예외:

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

reset

public void reset()
           throws IOException 

직전의 마크 위치에 스트림을 리셋 합니다. 마크가 설정되어 있지 않은 경우는, 선두 위치에 리셋 합니다.

오버라이드(override):

클래스 Reader 내의 reset

예외:

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

close

public void close()

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

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Reader 내의 close