StringTokenizer

java.lang.Object
   |
   +----java.util.StringTokenizer

public class StringTokenizer
extends Object
implements Enumeration

StringTokenizer 类允许一个应用把字符串分解成一个个标记。标记化方法比 StreamTokenizer 类使用的方法简单的多。 StringTokenizer 方法不区分标识符、数字和引用字符串，它们也不识别和跳过注释。

分隔符集合(分割标记的字符)可在创建时间指定或在每个标记基础上指定。

StringTokenizer 以下面两种方式的哪一种工作取决于创建它时带有的 returnTokens 标志值为 true 还是为 false：

    * 如果标志为 false, 则分隔符字符用于分割标记。标记是连续的非分隔符字符的最大序列。
    * 如果标志为 true, 分隔符字符被认为是标记。标记是一个分隔符字符或连续的非分隔符字符的最大序列。

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

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

打印下列输出结果：

         this
         is
         a
         test
    

来自：
    JDK1.0
参见：
    StreamTokenizer

构造子索引

StringTokenizer(String)
    为指定字符串构造一个 StringTokenizer 对象。
StringTokenizer(String, String)
    为指定字符串构造一个 StringTokenizer 对象。
StringTokenizer(String, String, boolean)
    为指定字符串构造一个 StringTokenizer 对象。

方法索引

countTokens()
    计算在生成异常之前，可调用该 tokenizer 的 nextToken 方法的次数。
hasMoreElements()
    该方法与 hasMoreTokens 方法返回同样的值。
hasMoreTokens()
    测试该 tokenizer 的字符串是否还有其它可用的标记。
nextElement()
    该方法与 nextToken 方法返回同样的值，除了它声明的返回值是 Object 而不是 String。
nextToken()
    返回该 string tokenizer 的下一个标记。
nextToken(String)
    返回该 string tokenizer 的字符串的下一个标记。

构造子
StringTokenizer

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

    为指定字符串构造一个 string tokenizer 对象。 在 delim 参数中的字符是分隔标记的分隔符。

    如果 returnTokens 标志为 true, 则分隔符字符也被作为标记返回。每个分隔符作为长度为一的字符串返回。如果标志为 false, 则跳过分隔符字符，且把它作为标记之间的分隔符。

    参数：
        str - 解析的字符串。
        delim - 分隔符。
        returnTokens - 指示是否返回作为标记的分隔符。

StringTokenizer

public StringTokenizer(String str,
                        String delim)

    为指定字符串构造一个 string tokenizer 对象。 在 delim 参数中的字符是分隔标记的分隔符。

    参数：
        str - 解析的字符串。
        delim - 分隔符。

StringTokenizer

public StringTokenizer(String str)

    为指定字符串构造一个 string tokenizer 对象。 tokenizer 使用缺省的分隔符设置，它是 "/t/n/r"：空格、制表符、换行符和回车。

    参数：
        str - 解析的字符串。

方法
hasMoreTokens

public boolean hasMoreTokens()

    测试该 tokenizer 的字符串是否还有其它可用的标记。

    返回值：
        如果有可用的标记返回 true ；否则返回 false。

nextToken

public String nextToken()

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

    返回值：
        该 string tokenizer 的下一个标记。
    抛出： NoSuchElementException
        如果在该 tokenizer 的字符串中不再有标记。

nextToken

public String nextToken(String delim)

    返回该 string tokenizer 的字符串的下一个标记。 在此调用之后，新的分隔符设置保持缺省。

    参数：
        delim - 新的分隔符。
    返回值：
        在转换到新的分隔符设置后的下一个标记。
    抛出： NoSuchElementException
        如果在该 tokenizer 的字符串中不再有标记。

hasMoreElements

public boolean hasMoreElements()

    该方法与 hasMoreTokens 方法返回同样的值。 它退出以便该类可以实现 Enumeration 接口。

    返回值：
        如果有标记返回 true ；否则返回 false 。
    参见：
        Enumeration, hasMoreTokens

nextElement

public Object nextElement()

    该方法与 nextToken 方法返回同样的值，除了它声明的返回值是 Object 而不是 String。 它存在以便该类可以实现 Enumeration 接口。

    返回值：
        该字符串中的下一个标记。
    抛出： NoSuchElementException
        如果在该 tokenizer 的字符串中不再有标记。
    参见：
        Enumeration, nextToken

countTokens

public int countTokens()

    计算在生成异常之前，可调用该 tokenizer 的 nextToken 方法的次数。

    返回值：
        使用当前分隔符集的保留在字符串中的标记数。
    参见：
        nextToken