java.util
클래스 StringTokenizer

java.lang.Object 
  java.util.StringTokenizer

모든 구현된 인터페이스:

Enumeration <Object >

public class StringTokenizer
extends Object 
implements Enumeration <Object >

StringTokenizer 클래스를 사용하면, 어플리케이션으로 캐릭터 라인을 토큰에 분할할 수 있습니다. 토큰화의 메서드는 StreamTokenizer 클래스에서 사용되고 있는 메서드보다 또한 간단합니다. StreamTokenizer 메서드에서는 식별자, 숫자, 인용 캐릭터 라인은 구별되지 않습니다. 또, 코멘트를 인식해 스킵 하는 일도 없습니다.

단락 문자 (토큰을 나누는 문자)는 클래스의 작성시, 또는 토큰을 얻을 때마다 지정할 수 있습니다.

StringTokenizer 인스턴스는 작성시의 returnDelims 플래그의 값이 true 나 false 등에 해서, 동작이 다릅니다.

• 플래그가 false인 경우는 단락 문자는 토큰을 나눌 뿐의 것이라고 보여진다. 토큰은 단락지어 문자가 아닌 문자가 1개 이상 연속하고 있는 부분이다
• 플래그가 true인 경우는 단락 문자는 그 자체가 토큰이라고 보여진다. 토큰은 1개의 단락 문자인가 단락 문자가 아닌 문자가 1개 이상 연속하고 있는 부분이다

StringTokenizer 객체는 내부적으로 토큰화 되는 캐릭터 라인내의 현재의 위치를 관리합니다. 몇개의 오퍼레이션은 이 현재의 위값이 처리된 문자의 끝에 진행하는 것이 있습니다.

토큰은, StringTokenizer 객체를 작성하는데 사용된 캐릭터 라인의 부분 캐릭터 라인을 얻는 것에 의해 리턴됩니다 .

사용예를 다음에 나타냅니다.

 StringTokenizer st = new StringTokenizer("this is a test");
 while (st.hasMoreTokens()) { System.out.println(st.nextToken());
 } 

화면에는 다음과 같이 표시됩니다.

 this is a test 

StringTokenizer는 호환성을 유지하는 목적으로 보관 유지되고 있는 유산 클래스이며, 새로운 코드에서는 사용이 추천하지 않습니다. 이 기능의 사용을 생각하고 있다면, String split 메서드 또는 java.util.regex 패키지를 대신에 사용하는 것을 추천합니다.

다음의 예는 String.split 메서드를 사용해 캐릭터 라인을 기본적인 토큰에 분할하는 방법을 나타냅니다.

 String[] result = "this is a test". split("\\s");
 for (int x=0;
 x<result.length;
 x++) System.out.println(result[x]);
 

화면에는 다음과 같이 표시됩니다.

 this is a test 

도입된 버전 :

JDK1. 0

관련 항목:

StreamTokenizer

생성자 개요

StringTokenizer (String str)
지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다.

StringTokenizer (String str, String delim)
지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다.

StringTokenizer (String str, String delim, boolean returnDelims)
지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다.

메서드 개요

int	countTokens () 예외를 생성하지 않고 토크나이자의 nextToken 메서드를 호출할 수 있는 회수를 계산합니다.
boolean	hasMoreElements () hasMoreTokens 메서드와 같은 값을 리턴합니다.
boolean	hasMoreTokens () 토크나이자의 캐릭터 라인으로 이용할 수 있는 토큰이 아직 있을지 어떨지를 판정합니다.
Object	nextElement () nextToken 메서드와 같은 값을 리턴합니다.
String	nextToken () 캐릭터 라인 토크나이자로부터 다음의 토큰을 리턴합니다.
String	nextToken (String delim) 캐릭터 라인 토크나이자의 캐릭터 라인으로부터 다음의 토큰을 리턴합니다.

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

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

생성자 상세

StringTokenizer

public StringTokenizer(String  str,
                       String  delim,
                       boolean returnDelims)

지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다. delim인수내의 모든 문자는 토큰을 단락짓기 위한 단락 문자입니다.

returnDelims 플래그가 true인 경우는 단락 문자도 토큰으로서 리턴됩니다 . 각 구 잘라 문자는 길이 1 캐릭터 라인으로서 리턴됩니다 . 플래그가 false인 경우는 단락 문자는 스킵 되어 토큰을 나눌 뿐의 것이라고 보여집니다.

delim가 null인 경우, 이 생성자는 예외를 Throw 하지 않습니다. 다만, 얻을 수 있던 StringTokenizer에 대해서 다른 메서드를 호출하려고 하면, NullPointerException이 발생되는 경우가 있습니다.

파라미터:

str - 구문 분석 되는 캐릭터 라인

delim - 단락 문자

returnDelims - 단락 문자를 토큰에 포함할지 어떨지를 나타내는 플래그

예외:

NullPointerException - str가 null인 경우

StringTokenizer

public StringTokenizer(String  str,
                       String  delim)

지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다. delim인수의 문자는 토큰을 나누는 단락 문자입니다. 단락 문자 그 자체가 토큰으로서 다루어질 것은 없습니다.

delim가 null인 경우, 이 생성자는 예외를 Throw 하지 않습니다. 다만, 얻을 수 있던 StringTokenizer에 대해서 다른 메서드를 호출하려고 하면, NullPointerException이 발생되는 경우가 있습니다.

파라미터:

str - 구문 분석 되는 캐릭터 라인

delim - 단락 문자

예외:

NullPointerException - str가 null인 경우

StringTokenizer

public StringTokenizer(String  str)

지정된 캐릭터 라인에 대한 StringTokenizer를 작성합니다. 토크나이자는 디폴트의 단락 캐릭터셋를 사용합니다. 이 세트는 「 \t\n\r\f」로 공백 문자, 탭 문자, 개행 문자, 복귀 개행 문자 및 용지 보내 문자로부터 구성됩니다. 단락 문자는 그 자체가 토큰으로서 처리될 것은 없습니다.

파라미터:

str - 구문 분석 되는 캐릭터 라인

예외:

NullPointerException - str가 null인 경우

메서드의 상세

hasMoreTokens

public boolean hasMoreTokens()

토크나이자의 캐릭터 라인으로 이용할 수 있는 토큰이 아직 있을지 어떨지를 판정합니다. 이 메서드가 true를 돌려주는 경우, 그 이후의 인수가 없는 nextToken에 의 호출은 적절히 토큰을 리턴합니다.

반환값:

캐릭터 라인내의 현재의 위치의 뒤로 1개 이상의 토큰이 있는 경우만 true, 그렇지 않은 경우는 false

nextToken

public String  nextToken()

캐릭터 라인 토크나이자로부터 다음의 토큰을 리턴합니다.

반환값:

캐릭터 라인 토크나이자로부터의 다음의 토큰

예외:

NoSuchElementException - 토크나이자의 캐릭터 라인에 토큰이 남지 않은 경우

nextToken

public String  nextToken(String  delim)

캐릭터 라인 토크나이자의 캐릭터 라인으로부터 다음의 토큰을 리턴합니다. 최초로StringTokenizer 객체가 단락지어 문자라고 보는 문자세트가 캐릭터 라인 delim 내의 문자가 되도록 변경됩니다. 다음에 캐릭터 라인내의 현재의 위치의 뒤에 있는 다음의 토큰이 리턴됩니다 . 현재의 위치는 인식된 토큰을 넘어 진행됩니다. 지정된 단락 문자의 집합은 이 호출의 뒤에도 기본값 로서 사용됩니다.

파라미터:

delim - 새로운 단락 문자

반환값:

새로운 단락 문자로 전환한 뒤의 토큰

예외:

NoSuchElementException - 토크나이자의 캐릭터 라인에 토큰이 남지 않은 경우

NullPointerException - delim가 null인 경우

hasMoreElements

public boolean hasMoreElements()

hasMoreTokens 메서드와 같은 값을 리턴합니다. 이것을 사용하면, 이 클래스에 Enumeration인터페이스를 구현할 수 있습니다 .

정의:

인터페이스 Enumeration <Object > 내의 hasMoreElements

반환값:

토크나이자 캐릭터 라인으로 이용할 수 있는 토큰이 아직 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Enumeration, hasMoreTokens()

nextElement

public Object  nextElement()

nextToken 메서드와 같은 값을 리턴합니다. 다만, 선언된 반환값은, String는 아니고 Object 입니다. 이것을 사용해 이 클래스에 Enumeration인터페이스를 구현할 수 있습니다 .

정의:

인터페이스 Enumeration <Object > 내의 nextElement

반환값:

캐릭터 라인의 다음의 토큰

예외:

NoSuchElementException - 토크나이자의 캐릭터 라인에 토큰이 남지 않은 경우

관련 항목:

Enumeration, nextToken()

countTokens

public int countTokens()

예외를 생성하지 않고 토크나이자의 nextToken 메서드를 호출할 수 있는 회수를 계산합니다. 현재의 위치로 나아가지 않습니다.

반환값:

현재의 단락 문자를 적용했을 때에 캐릭터 라인에 남아 있는 토큰의 수

관련 항목:

nextToken()