java.util
类 StringTokenizer

java.lang.Object
  java.util.StringTokenizer

所有已实现的接口：

Enumeration<Object>

public class StringTokenizer
extends Object
implements Enumeration<Object>

string tokenizer 类允许应用程序将字符串分解为标记。tokenization 方法比 StreamTokenizer 类所使用的方法更简单。StringTokenizer 方法不区分标识符、数和带引号的字符串，它们也不识别并跳过注释。

可以在创建时指定，也可以根据每个标记来指定分隔符（分隔标记的字符）集。

StringTokenizer 的实例有两种行为方式，这取决于它在创建时使用的 returnDelims 标志的值是 true 还是 false：

• 如果标志为 false，则分隔符字符用来分隔标记。标记是连续字符（不是分隔符）的最大序列。
• 如果标志为 true，则认为那些分隔符字符本身即为标记。因此标记要么是一个分隔符字符，要么是那些连续字符（不是分隔符）的最大序列。

StringTokenizer 对象在内部维护字符串中要被标记的当前位置。某些操作将此当前位置移至已处理的字符后。

通过截取字符串的一个子串来返回标记，该字符串用于创建 StringTokenizer 对象。

下面是一个使用 tokenizer 的实例。代码如下：

     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

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

为指定字符串构造一个 string tokenizer。delim 参数中的所有字符都是分隔标记的分隔符。

如果 returnDelims 标志为 true，则分隔符字符也作为标记返回。每个分隔符都作为一个长度为 1 的字符串返回。如果标志为 false，则跳过分隔符，只是用作标记之间的分隔符。

注意，如果 delim 为 null，则此构造方法不抛出异常。但是，尝试对得到的 StringTokenizer 调用其他方法则可能抛出 NullPointerException。

参数：

str - 要解析的字符串。

delim - 分隔符。

returnDelims - 指示是否将分隔符作为标记返回的标志。

抛出：

NullPointerException - 如果 str 为 null。

StringTokenizer

public StringTokenizer(String str,
                       String delim)

为指定字符串构造一个 string tokenizer。delim 参数中的字符都是分隔标记的分隔符。分隔符字符本身不作为标记。

注意，如果 delim 为 null，则此构造方法不抛出异常。但是，尝试对得到的 StringTokenizer 调用其他方法则可能抛出 NullPointerException。

参数：

str - 要解析的字符串。

delim - 分隔符。

抛出：

NullPointerException - 如果 str 为 null。

StringTokenizer

public StringTokenizer(String str)

为指定字符串构造一个 string tokenizer。tokenizer 使用默认的分隔符集 " \t\n\r\f"，即：空白字符、制表符、换行符、回车符和换页符。分隔符字符本身不作为标记。

参数：

str - 要解析的字符串。

抛出：

NullPointerException - 如果 str 为 null。

hasMoreTokens

public boolean hasMoreTokens()

测试此 tokenizer 的字符串中是否还有更多的可用标记。如果此方法返回 true，那么后续调用无参数的 nextToken 方法将成功地返回一个标记。

返回：

当且仅当该字符串中当前位置后至少有一个标记时才为 true；否则为 false。

nextToken

public String nextToken()

返回此 string tokenizer 的下一个标记。

返回：

此 string tokenizer 的下一个标记。

抛出：

NoSuchElementException - 如果此 tokenizer 的字符串中没有更多标记。

nextToken

public String nextToken(String delim)

返回此 string tokenizer 的字符串中的下一个标记。首先，字符集被更改为字符串 delim 中的字符，该字符集被认为是 StringTokenizer 对象的分隔符。接着返回字符串中当前位置之后的下一个标记。当前位置被提前到所识别的标记前。进行此调用后新的分隔符集仍然保持默认值。

参数：

delim - 新的分隔符。

返回：

转换到新的分隔符集后的下一个标记。

抛出：

NoSuchElementException - 如果此 tokenizer 的字符串中没有更多标记。

NullPointerException - 如果 delim 为 null。

hasMoreElements

public boolean hasMoreElements()

返回与 hasMoreTokens 方法相同的值。它的存在使得此类可以实现 Enumeration 接口。

指定者：

接口 Enumeration<Object> 中的 hasMoreElements

返回：

如果有更多标记，则为 true；否则为 false。

另请参见：

Enumeration, hasMoreTokens()

nextElement

public Object nextElement()

除了其声明返回值是 Object 而不是 String 之外，它返回与 nextToken 方法相同的值。它的存在使得此类可以实现 Enumeration 接口。

指定者：

接口 Enumeration<Object> 中的 nextElement

返回：

字符串中的下一个标记。

抛出：

NoSuchElementException - 如果此 tokenizer 的字符串中没有更多标记。

另请参见：

Enumeration, nextToken()

countTokens

public int countTokens()

计算在生成异常之前可以调用此 tokenizer 的 nextToken 方法的次数。当前位置没有提前。

返回：

使用当前分隔符集的字符串中剩余的标记数。

另请参见：

nextToken()

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。