java.io
클래스 StreamTokenizer

java.lang.Object 
  java.io.StreamTokenizer

public class StreamTokenizer
extends Object 

입력 스트림을 인수에 취해, 그것을 「토큰」에 구문 분석 해, 한 번에 1개의 토큰을 읽을 수 있도록 합니다. 구문 분석 처리는 다양한 상태로 설정 가능한 많은 플래그와 1개의 테이블에 의해 제어합니다. 스트림토크나이자는 식별자, 수치, 인용 캐릭터 라인 및 각종의 코멘트 스타일을 인식할 수 있습니다.

입력 스트림로부터 읽히는 각 바이트는 '\u0000' ~ '\u00FF' 범위의 문자라고 보여집니다. 이 문자치를 사용해, 문자의 5개의 속성, 즉, 「공백」, 「영문자」, 「수치」, 「인용 캐릭터 라인」 및 「코멘트 문자」를 검색합니다. 각 문자는 이러한 속성을 가지지 않는 것도, 복수 가질 수도 있습니다.

게다가 인스턴스에는 4개의 플래그가 있습니다. 이러한 플래그가 가리키는 내용은 다음과 같습니다.

• 줄 끝 기호를, 토큰으로서 돌려주는지, 또는 토큰을 단락지을 뿐의 공백 문자로서 취급하는지를 나타낸다
• C 스타일의 코멘트를 인식해 스킵 할지 어떨지를 나타낸다
• C++ 스타일의 코멘트를 인식해 스킵 할지 어떨지를 나타낸다
• 식별자의 문자를 소문자로 변환할지 어떨지를 나타낸다

일반적인 어플리케이션은 최초로 이 클래스의 인스턴스를 생성하고 나서, 구문 테이블을 설정해, 그 후에 루프의 각 반복내에서 nextToken 메서드를 호출해, 값 TT_EOF가 돌려주고질 때까지 이 루프를 반복합니다.

도입된 버전 :

JDK1. 0

관련 항목:

nextToken(), TT_EOF

필드 개요

double	nval 현재의 토큰이 수치의 경우, 이 필드에는 그 수값이 들어갑니다.
String	sval 현재의 토큰이 워드 토큰의 경우, 이 필드에는 워드 토큰의 문자를 나타내는 캐릭터 라인이 들어갑니다.
static int	TT_EOF 스트림의 마지막이 읽힌 것을 나타내는 정수입니다.
static int	TT_EOL 행의 마지막이 읽힌 것을 나타내는 정수입니다.
static int	TT_NUMBER 수치 토큰이 읽힌 것을 나타내는 정수입니다.
static int	TT_WORD 워드 토큰이 읽힌 것을 나타내는 정수입니다.
int	ttype nextToken 메서드의 호출뒤, 이 필드에는 읽힌지 얼마 안된 토큰의 형태가 들어갑니다.

생성자 개요

StreamTokenizer (InputStream is)
추천하지 않습니다. JDK 1.1 현재, 입력 스트림을 토큰화하려면, 다음과 같이의해 입력 스트림을 문자 스트림로 변환할 방법이 적절합니다.

 Reader r = new BufferedReader(new InputStreamReader(is)); StreamTokenizer st = new StreamTokenizer(r); 

StreamTokenizer (Reader r)
지정된 문자 스트림을 구문 분석 하는 토크나이자를 작성합니다.

메서드 개요

void	commentChar (int ch) 인수로 지정된 문자 그 뒤로는 1 행의 코멘트행인 것을 지정합니다.
void	eolIsSignificant (boolean flag) 행의 마지막을 토큰으로서 처리할지 어떨지를 판별합니다.
int	lineno () 현재의 행 번호를 리턴합니다.
void	lowerCaseMode (boolean fl) 워드 토큰을 자동적으로 소문자로 할지 어떨지를 판별합니다.
int	nextToken () 이 토크나이자의 입력 스트림의 다음의 토큰을 구문 분석 합니다.
void	ordinaryChar (int ch) 문자 인수가 이 토크나이자의 「보통 」문자인 것을 지정합니다.
void	ordinaryChars (int low, int hi) low <= c <= high 범위내의 모든 문자 c 가 이 토크나이자의 「보통 」문자인 것을 지정합니다.
void	parseNumbers () 이 토크나이자로 수치를 구문 분석 하도록 지정합니다.
void	pushBack () 이 토크나이자의 다음의 nextToken 메서드 호출로 ttype 필드의 현행치를 돌려주고, nval 또는 sval 필드의 값은 변경하지 않게 합니다.
void	quoteChar (int ch) 이 문자에 일치하는 페어로 이 토크나이자의 캐릭터 라인 정수를 단락짓도록 지정합니다.
void	resetSyntax () 이 토크나이자의 구문 테이블을 리셋 해, 모든 문자를 「보통 」문자로 합니다.
void	slashSlashComments (boolean flag) 토크나이자가 C++ 스타일의 코멘트를 인식할지 어떨지를 판별합니다.
void	slashStarComments (boolean flag) 토크나이자가 C 스타일의 코멘트를 인식할지 어떨지를 판별합니다.
String	toString () 현재의 스트림 토큰의 캐릭터 라인 표현과 그것이 생성된 행 번호를 리턴합니다.
void	whitespaceChars (int low, int hi) low <= c <= high 범위내의 모든 문자 c 가 공백 문자인 것을 지정합니다.
void	wordChars (int low, int hi) low <= c <= high 범위내의 모든 문자 c가 워드 문자인 것을 지정합니다.

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

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

필드의 상세

ttype

public int ttype

nextToken 메서드의 호출뒤, 이 필드에는 읽힌지 얼마 안된 토큰의 형태가 들어갑니다. 단일 문자 토큰의 경우, 그 값은 정수에 변환된 단일 문자입니다. 인용 캐릭터 라인 토큰의 경우, 그 값은 인용 문자입니다. 그 외의 경우는 다음의 값의 어떤 것인가가 됩니다.

• TT_WORD는 토큰이 워드인 것을 나타낸다
• TT_NUMBER는 토큰이 수치인 것을 나타낸다
• TT_EOL는 행의 마지막에 이른 것을 나타낸다. 필드에 이 값이 들어오는 것은 인수에 true를 지정해 eolIsSignificant 메서드가 불려 갔을 경우만
• TT_EOF는 입력 스트림의 마지막에 이른 것을 나타낸다

이 필드의 초기값 는 -4 입니다.

관련 항목:

eolIsSignificant(boolean), nextToken(), quoteChar(int), TT_EOF, TT_EOL, TT_NUMBER, TT_WORD

TT_EOF

public static final int TT_EOF

스트림의 마지막이 읽힌 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

TT_EOL

public static final int TT_EOL

행의 마지막이 읽힌 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

TT_NUMBER

public static final int TT_NUMBER

수치 토큰이 읽힌 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

TT_WORD

public static final int TT_WORD

워드 토큰이 읽힌 것을 나타내는 정수입니다.

관련 항목:

정수 필드값

sval

public String  sval

현재의 토큰이 워드 토큰의 경우, 이 필드에는 워드 토큰의 문자를 나타내는 캐릭터 라인이 들어갑니다. 현재의 토큰이 인용 캐릭터 라인 토큰의 경우, 이 필드에는 캐릭터 라인의 본체가 들어갑니다.

ttype 필드의 값이 TT_WORD인 경우, 현재의 토큰은 워드입니다. ttype 필드의 값이 인용 문자의 경우, 현재의 토큰은 인용 캐릭터 라인 토큰입니다.

이 필드의 초기값 는 null 입니다.

관련 항목:

quoteChar(int), TT_WORD, ttype

nval

public double nval

현재의 토큰이 수치의 경우, 이 필드에는 그 수값이 들어갑니다. ttype 필드가 TT_NUMBER인 경우, 현재의 토큰은 수치입니다.

이 필드의 초기값 는 0.0 입니다.

관련 항목:

TT_NUMBER, ttype

생성자 상세

StreamTokenizer

@Deprecated 
public StreamTokenizer(InputStream  is)

추천하지 않습니다. JDK 1.1 현재, 입력 스트림을 토큰화하려면, 다음과 같이의해 입력 스트림을 문자 스트림로 변환할 방법이 적절합니다.

 Reader r = new BufferedReader(new InputStreamReader(is)); StreamTokenizer st = new StreamTokenizer(r); 

지정된 입력 스트림을 구문 분석 하는 스트림토크나이자를 작성합니다. 스트림토크나이자는 다음의 디폴트 상태에 초기화됩니다.

• 'A' ~ 'Z', 'a' ~ 'z' 및 '\u00A0' ~ '\u00FF' 바이트값는 모두 영문자라고 본다
• '\u0000' ~ '\u0020' 바이트값는 모두 공백이라고 본다
• '/'는 코멘트 문자
• 단일 인용부호 '\''와 이중 인용부호 '"'는 캐릭터 라인의 인용 문자
• 수치는 구문 분석 된다
• 줄 끝 기호는 독립한 토큰은 아니고 공백 문자로서 취급한다
• C 스타일 및 C++ 스타일의 코멘트는 인식하지 않는다

파라미터:

is - 입력 스트림

관련 항목:

BufferedReader, InputStreamReader, StreamTokenizer(java.io.Reader)

StreamTokenizer

public StreamTokenizer(Reader  r)

지정된 문자 스트림을 구문 분석 하는 토크나이자를 작성합니다.

파라미터:

r - 입력 스트림을 제공하는 Reader 객체

도입된 버전 :

JDK1. 1

메서드의 상세

resetSyntax

public void resetSyntax()

이 토크나이자의 구문 테이블을 리셋 해, 모든 문자를 「보통 」문자로 합니다. 보통 문자의자세한 내용은 ordinaryChar 메서드를 참조하십시오.

관련 항목:

ordinaryChar(int)

wordChars

public void wordChars(int low,
                      int hi)

low <= c <= high 범위내의 모든 문자 c가 워드 문자인 것을 지정합니다. 워드 토큰은 워드 원가요소의 뒤에 제로개이상의 워드 원가요소 또는 수치 원가요소가 계속된 것입니다.

파라미터:

low - 범위의 최소값

hi - 범위의 최대값

whitespaceChars

public void whitespaceChars(int low,
                            int hi)

low <= c <= high 범위내의 모든 문자 c 가 공백 문자인 것을 지정합니다. 공백 문자의 기능은 입력 스트림내에서 토큰을 단락짓는 것 뿐입니다.

지정의 범위에 있는 문자의 그 외의 속성 설정은 클리어 됩니다.

파라미터:

low - 범위의 최소값

hi - 범위의 최대값

ordinaryChars

public void ordinaryChars(int low,
                          int hi)

low <= c <= high 범위내의 모든 문자 c 가 이 토크나이자의 「보통 」문자인 것을 지정합니다. 보통 문자의자세한 내용은 ordinaryChar 메서드를 참조하십시오.

파라미터:

low - 범위의 최소값

hi - 범위의 최대값

관련 항목:

ordinaryChar(int)

ordinaryChar

public void ordinaryChar(int ch)

문자 인수가 이 토크나이자의 「보통 」문자인 것을 지정합니다. 코멘트 문자, 워드 원가요소, 캐릭터 라인 단락 문자, 공백, 또는 수치 문자로서 문자가 가지는 특수한 미는 제거됩니다. 파서는 이러한 문자를 검출하면, 이것을 단일의 문자 토큰으로서 취급해, ttype 필드에 문자의 값을 설정합니다.

줄 끝 문자를 「보통 」문자로 하면, StreamTokenizer 행 카운트 기능을 방해하는 일이 있습니다. lineno 메서드는 행 카운트에 줄 끝 문자를 포함하지 않는 경우가 있습니다.

파라미터:

ch - 문자

관련 항목:

ttype

commentChar

public void commentChar(int ch)

인수로 지정된 문자 그 뒤로는 1 행의 코멘트행인 것을 지정합니다. 스트림토크나이자는 코멘트 문자로부터 행의 마지막까지의 사이의 문자를 모두 무시합니다.

지정의 문자의, 그 외의 속성 설정은 클리어 됩니다.

파라미터:

ch - 문자

quoteChar

public void quoteChar(int ch)

이 문자에 일치하는 페어로 이 토크나이자의 캐릭터 라인 정수를 단락짓도록 지정합니다.

nextToken 메서드가 캐릭터 라인 정수를 검출하면, ttype 필드에는 캐릭터 라인 단락 문자가 설정되어sval 필드에는 캐릭터 라인의 본체가 설정됩니다.

캐릭터 라인의 인용 문자가 검출되면, 캐릭터 라인의 구성은 다음과 같이 인식됩니다. 캐릭터 라인의 인용 문자 (이것은 포함하지 않는다)의 뒤에 계속되는 모든 문자, 같은 캐릭터 라인의 인용 문자의 다음의 출현 장소 (이것은 포함하지 않는다)까지의 모든 문자, 또는 줄 끝 기호, 또는 파일의 마지막. 보통 의 ESC 순서 (예를 들어 "\n" 나 "\t" 등)는 인식되어 캐릭터 라인의 구문 분석시에 단일 문자에 변환됩니다.

지정의 문자의, 그 외의 속성 설정은 클리어 됩니다.

파라미터:

ch - 문자

관련 항목:

nextToken(), sval, ttype

parseNumbers

public void parseNumbers()

이 토크나이자로 수치를 구문 분석 하도록 지정합니다. 이 토크나이자의 구문 테이블은 변경되어 아래의 12 각 문자가 수치 속성을 가지게 됩니다.

 0 1 2 3 4 5 6 7 8 9 .  - 

「수치」속성을 가진다

파서는 배정밀도의 부동 소수점수(실수)의 형식의 워드 토큰을 검출하면, ttype 필드에 값 TT_NUMBER를 설정해, 토큰의 수치를 nval 필드에 들어갈 수 있어, 이 토큰을 워드가 아니고 수값으로 취급합니다.

관련 항목:

nval, TT_NUMBER, ttype

eolIsSignificant

public void eolIsSignificant(boolean flag)

행의 마지막을 토큰으로서 처리할지 어떨지를 판별합니다. flag 인수가 true인 경우, 이 토크나이자는 행의 마지막을 토큰으로서 처리합니다. 행의 마지막이 읽히면, nextToken 메서드는 TT_EOL를 돌려주고, ttype 필드에 이 값을 설정합니다.

행은 복귀 문자 ('\r') 또는 개행 문자 ('\n')로 끝나는 문자 순서입니다. 또, 직후에 개행 문자가 계속되는 복귀 문자는 줄 끝을 나타내는 단일의 토큰으로서 다루어집니다.

flag가 false인 경우, 줄 끝 문자는 공백으로서 다루어져 그 기능은 토큰을 단락지을 뿐입니다.

파라미터:

flag - true는 줄 끝 문자가 독립한 토큰인 것을 나타낸다. false는 줄 끝 문자가 공백인 것을 나타내는

관련 항목:

nextToken(), ttype, TT_EOL

slashStarComments

public void slashStarComments(boolean flag)

토크나이자가 C 스타일의 코멘트를 인식할지 어떨지를 판별합니다. flag 인수가 true인 경우, 이 스트림토크나이자는 C 스타일의 코멘트를 인식합니다. /* (와)과 */ 사이의 텍스트는 모두 파기됩니다.

false인수가 false인 경우, C 스타일의 코멘트는 특별히는 다루어지지 않습니다.

파라미터:

flag - true는 C 스타일의 코멘트를 인식해 무시하는 것을 나타낸다

slashSlashComments

public void slashSlashComments(boolean flag)

토크나이자가 C++ 스타일의 코멘트를 인식할지 어떨지를 판별합니다. flag 인수가 true인 경우, 이 스트림토크나이자는 C++ 스타일의 코멘트를 인식합니다. slash 문자 ('/')가 2개 계속되는 경우, 이것은 행의 마지막까지 계속되는 코멘트의 시작을의미합니다.

false인수가 false인 경우, C++ 스타일의 코멘트는 특별히는 다루어지지 않습니다.

파라미터:

flag - true는 C++ 스타일의 코멘트를 인식해 무시하는 것을 나타낸다

lowerCaseMode

public void lowerCaseMode(boolean fl)

워드 토큰을 자동적으로 소문자로 할지 어떨지를 판별합니다. flag 인수가 true인 경우, 워드 토큰이 돌려주고질 때마다 sval 필드의 값이 소문자로 됩니다. ttype 필드가 가지는 값 TT_WORD는 이 토크나이자의 nextToken 메서드로부터의 것입니다.

flag 인수가 false인 경우, sval 필드는 변경되지 않습니다.

파라미터:

fl - true는 모든 워드 토큰을 소문자로 하는 것을 나타내는

관련 항목:

nextToken(), ttype, TT_WORD

nextToken

public int nextToken()
              throws IOException 

이 토크나이자의 입력 스트림의 다음의 토큰을 구문 분석 합니다. 다음의 토큰의 형태는 ttype 필드에 리턴됩니다 . 토큰에 관한 보충 정보는 이 토크나이자의 nval 필드 또는 sval 필드에 있습니다.

이 클래스의 일반적인 클라이언트는 우선 최초로 구문 테이블을 설정하고 나서 nextToken를 호출하는 루프에 들어가 TT_EOF가 돌려주고질 때까지 토큰을 차례차례 구문 분석 합니다.

반환값:

ttype 필드의 값

예외:

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

관련 항목:

nval, sval, ttype

pushBack

public void pushBack()

이 토크나이자의 다음의 nextToken 메서드 호출로 ttype 필드의 현행치를 돌려주고, nval 또는 sval 필드의 값은 변경하지 않게 합니다.

관련 항목:

nextToken(), nval, sval, ttype

lineno

public int lineno()

현재의 행 번호를 리턴합니다.

반환값:

이 스트림토크나이자의 현재의 행 번호

toString

public String  toString()

현재의 스트림 토큰의 캐릭터 라인 표현과 그것이 생성된 행 번호를 리턴합니다.

리턴된 정확한 문자는 지정되지 않습니다 만, 다음의 예가 전형적이다라고 되고 있습니다.

Token['a'], line 10

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 토큰의 캐릭터 라인 표현

관련 항목:

nval, sval, ttype