java.io
클래스 LineNumberReader

java.lang.Object 
  java.io.Reader 
      java.io.BufferedReader 
          java.io.LineNumberReader

모든 구현된 인터페이스:

Closeable , Readable

public class LineNumberReader
extends BufferedReader 

행 번호를 추적해 관리하는, 버퍼링 된 문자 입력 스트림입니다. 이 클래스에는, 현재의 행 번호를 설정하는 setLineNumber(int) 메소드와 현재의 행 번호를 취득하는 getLineNumber() 메소드가 정의되고 있습니다.

디폴트에서는, 행 번호는 0 으로부터 시작됩니다. 행 번호는, 데이터가 읽혀줄 끝 기호가 발견될 때마다 증가합니다. 행 번호를 변경할 때는,setLineNumber(int) 를 호출합니다. 다만,setLineNumber(int) 는, 스트림내의 현재 위치를 실제로 변경하는 것이 아니라,getLineNumber() 로부터 반환되는 값을 변경할 뿐입니다.

1 행은, 개행 ('\n'), 왕복대 리턴 ('\r'), 왕복대 리턴과 거기에 계속되는 개행의 어느 쪽인가에 따라종료한다고 인식됩니다.

도입된 버젼:

JDK1. 1

필드의 개요

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

lock

생성자 의 개요

LineNumberReader (Reader in)
디폴트의 입력 버퍼 사이즈를 사용해, 행 번호 첨부 리더를 새롭게 작성합니다.

LineNumberReader (Reader in, int sz)
지정된 사이즈의 버퍼에 문자를 읽어들이는, 행 번호 첨부 리더를 새롭게 작성합니다

메소드의 개요

int	getLineNumber () 행 번호의 현재가를 가져옵니다.
void	mark (int readAheadLimit) 스트림의 현재 위치에 마크를 설정합니다.
int	read () 단일의 문자를 읽어들입니다.
int	read (char[] cbuf, int off, int len) 배열의 일부에 문자를 읽어들입니다.
String	readLine () 텍스트를 1 행 읽어들입니다.
void	reset () 스트림을, 가장 새로운 마크 위치에 리셋 합니다.
void	setLineNumber (int lineNumber) 현재의 행 번호를 설정합니다.
long	skip (long n) 문자를 스킵 합니다.

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

close , markSupported , ready

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

read , read

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

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

생성자 의 상세

LineNumberReader

public LineNumberReader(Reader  in)

디폴트의 입력 버퍼 사이즈를 사용해, 행 번호 첨부 리더를 새롭게 작성합니다.

파라미터:

in - 기본이 되는 스트림을 제공하는 Reader 객체

LineNumberReader

public LineNumberReader(Reader  in,
                        int sz)

지정된 사이즈의 버퍼에 문자를 읽어들이는, 행 번호 첨부 리더를 새롭게 작성합니다

파라미터:

in - 기본이 되는 스트림을 제공하는 Reader 객체

sz - 버퍼의 사이즈를 지정하는 int

메소드의 상세

setLineNumber

public void setLineNumber(int lineNumber)

현재의 행 번호를 설정합니다.

파라미터:

lineNumber - 행 번호를 지정하는 int

관련 항목:

getLineNumber()

getLineNumber

public int getLineNumber()

행 번호의 현재가를 가져옵니다.

반환값:

현재의 행 번호

관련 항목:

setLineNumber(int)

read

public int read()
         throws IOException 

단일의 문자를 읽어들입니다. 줄 끝 기호는 1 개의 개행 문자 ('\n')에 변환됩니다. 줄 끝 기호가 읽힐 때마다, 현재의 행 번호가 증가합니다.

오버라이드(override):

클래스 BufferedReader 내의 read

반환값:

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

예외:

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

read

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

배열의 일부에 문자를 읽어들입니다. 줄 끝 기호가 읽힐 때마다, 현재의 행 번호가 증가합니다.

오버라이드(override):

클래스 BufferedReader 내의 read

파라미터:

cbuf - 전송처 버퍼

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

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

반환값:

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

예외:

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

readLine

public String  readLine()
                throws IOException 

텍스트를 1 행 읽어들입니다. 줄 끝 기호가 읽힐 때마다, 현재의 행 번호가 증가합니다.

오버라이드(override):

클래스 BufferedReader 내의 readLine

반환값:

행의 내용을 포함한 캐릭터 라인, 다만행의 끝 문자는 포함하지 않는다. 스트림의 마지막에 이르고 있는 경우는 null

예외:

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

skip

public long skip(long n)
          throws IOException 

문자를 스킵 합니다.

오버라이드(override):

클래스 BufferedReader 내의 skip

파라미터:

n - 스킵 하는 문자수

반환값:

실제로 스킵 한 문자수

예외:

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

IllegalArgumentException - n 가 0 보다 작은 값의 경우

mark

public void mark(int readAheadLimit)
          throws IOException 

스트림의 현재 위치에 마크를 설정합니다. 이후의 reset()의 호출에서는, 이 정도치에의 스트림의 재배치를 시도해 거기에 합해 행 번호도 리셋 됩니다.

오버라이드(override):

클래스 BufferedReader 내의 mark

파라미터:

readAheadLimit - 마크를 보관 유지하면서 읽어들일 수가 있는 문자수의 상한. 이 수의 문자를 읽어들인 후에 스트림을 리셋 하려고 하면(자) 실패하는 경우가 있다

예외:

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

reset

public void reset()
           throws IOException 

스트림을, 가장 새로운 마크 위치에 리셋 합니다.

오버라이드(override):

클래스 BufferedReader 내의 reset

예외:

IOException - 스트림에 마크가 설정되어 있지 않았던 경우, 또는 마크가 무효가 되어 있었을 경우