java.io
클래스 LineNumberReader

java.lang.Object 
  |
  +--java.io.Reader 
        |
        +--java.io.BufferedReader 
              |
              +--java.io.LineNumberReader

public class LineNumberReader

extends BufferedReader

행 번호를 추적해 관리하는 버퍼링 된 캐릭터 입력 스트림입니다. 이 클래스에는 현재의 행 번호를 설정하는 void setLineNumber(int) 메소드와 현재의 행 번호를 취득하는 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 () 1 개의 캐릭터를 읽어들입니다.
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

클래스 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 개의 캐릭터를 읽어들입니다. 행의 종단은 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 행의 텍스트를 읽어들입니다. 1 행의 종단은 개행 ('\n')인가, 복귀 ('\r'), 또는 복행으로 거기에 계속되는 개행의 어떤 것인가로 인식됩니다.

오버라이드(override):

클래스 BufferedReader 내의 readLine

반환값:

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

예외:

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

skip

public long skip(long n)
          throws IOException 

캐릭터를 스킵 합니다.

오버라이드(override):

클래스 BufferedReader 내의 skip

파라미터:

n - 스킵 하는 캐릭터수

반환값:

실제로 스킵 한 캐릭터수

예외:

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

mark

public void mark(int readAheadLimit)
          throws IOException 

스트림의 현재 위치에 마크를 설정합니다. 이것에 이어 reset()를 호출하면(자), 스트림을 현재의 마크 위치에 리셋트 해, 거기에 합해 행 번호를 리셋트 합니다.

오버라이드(override):

클래스 BufferedReader 내의 mark

파라미터:

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

예외:

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

reset

public void reset()
           throws IOException 

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

오버라이드(override):

클래스 BufferedReader 내의 reset

예외:

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