java.util
Class StringTokenizer
java.lang.Object
|
+--java.util.StringTokenizer
All Implemented Interfaces:
Enumeration
This class splits a string into tokens. The caller can set on which
delimiters the string should be split and if the delimiters should be
returned. This is much simpler than java.io.StreamTokenizer.
You may change the delimiter set on the fly by calling
nextToken(String). But the semantic is quite difficult; it even
depends on calling hasMoreTokens()
. You should call
hasMoreTokens()
before, otherwise the old delimiters
after the last token are candidates for being returned.
If you want to get the delimiters, you have to use the three argument
constructor. The delimiters are returned as token consisting of a
single character.
Authors:- Jochen Hoenicke
- Warren Levy <warrenl@cygnus.com>
See Also:
StringTokenizer
public StringTokenizer(java.lang.String str)
Creates a new StringTokenizer for the string str
,
that should split on the default delimiter set (space, tab,
newline, return and formfeed), and which doesn't return the
delimiters.
Parameters:
Throws:
StringTokenizer
public StringTokenizer(java.lang.String str, java.lang.String delim)
Create a new StringTokenizer, that splits the given string on
the given delimiter characters. It doesn't return the delimiter
characters.
Parameters:
Throws:
StringTokenizer
public StringTokenizer(java.lang.String str, java.lang.String delim, boolean returnDelims)
Create a new StringTokenizer, that splits the given string on
the given delimiter characters. If you set
returnDelims
to true
, the delimiter
characters are returned as tokens of their own. The delimiter
tokens always consist of a single character.
Parameters:
Throws:
countTokens
public int countTokens()
This counts the number of remaining tokens in the string, with
respect to the current delimiter set.
Returns:
- the number of times
nextTokens()
will succeed
See Also:
hasMoreElements
public boolean hasMoreElements()
This does the same as hasMoreTokens. This is the
Enumeration
Returns:- true, if the next call of nextElement() will succeed
See Also:
hasMoreTokens
public boolean hasMoreTokens()
Tells if there are more tokens.
Returns:- true if the next call of nextToken() will succeed
nextElement
public Object nextElement()
This does the same as nextTokens. This is the
Enumeration
Returns:- the next token with respect to the current delimiter characters
Throws:See Also:
nextToken
public String nextToken()
Returns the nextToken of the string.
Returns:- the next token with respect to the current delimiter characters
Throws:
nextToken
public String nextToken(java.lang.String delim)
Returns the nextToken, changing the delimiter set to the given
delim
. The change of the delimiter set is
permanent, ie. the next call of nextToken(), uses the same
delimiter set.
Parameters:Returns:- the next token with respect to the new delimiter characters
Throws:
You may change the delimiter set on the fly by calling nextToken(String). But the semantic is quite difficult; it even depends on calling
hasMoreTokens()
. You should callhasMoreTokens()
before, otherwise the old delimiters after the last token are candidates for being returned.If you want to get the delimiters, you have to use the three argument constructor. The delimiters are returned as token consisting of a single character.