java.lang.Object | |
↳ | java.util.StringTokenizer |
The StringTokenizer
class allows an application to break a string
into tokens by performing code point comparison. The StringTokenizer
methods do not distinguish among identifiers, numbers, and quoted strings,
nor do they recognize and skip comments.
The set of delimiters (the codepoints that separate tokens) may be specified either at creation time or on a per-token basis.
An instance of StringTokenizer
behaves in one of three ways,
depending on whether it was created with the returnDelimiters
flag
having the value true
or false
:
false
, delimiter code points serve to separate
tokens. A token is a maximal sequence of consecutive code points that are not
delimiters.
true
, delimiter code points are themselves
considered to be tokens. In this case a token will be received for each
delimiter code point.
A token is thus either one delimiter code point, or a maximal sequence of consecutive code points that are not delimiters.
A StringTokenizer
object internally maintains a current position
within the string to be tokenized. Some operations advance this current
position past the code point processed.
A token is returned by taking a substring of the string that was used to
create the StringTokenizer
object.
Here's an example of the use of the default delimiter StringTokenizer
:
StringTokenizer st = new StringTokenizer("this is a test"); while (st.hasMoreTokens()) { println(st.nextToken()); }
This prints the following output:
this is a test
Here's an example of how to use a StringTokenizer
with a user
specified delimiter:
StringTokenizer st = new StringTokenizer( "this is a test with supplementary characters ?𐀀?", " 𐀀"); while (st.hasMoreTokens()) { println(st.nextToken()); }
This prints the following output:
this is a test with supplementary characters ? ?
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new
StringTokenizer for the parameter string using
whitespace as the delimiter. | |||||||||||
Constructs a new
StringTokenizer for the parameter string using
the specified delimiters. | |||||||||||
Constructs a new
StringTokenizer for the parameter string using
the specified delimiters, returning the delimiters as tokens if the
parameter returnDelimiters is true . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns the number of unprocessed tokens remaining in the string.
| |||||||||||
Returns
true if unprocessed tokens remain. | |||||||||||
Returns
true if unprocessed tokens remain. | |||||||||||
Returns the next token in the string as an
Object . | |||||||||||
Returns the next token in the string as a
String . | |||||||||||
Returns the next token in the string as a
String . |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class java.lang.Object
| |||||||||||
From interface java.util.Enumeration
|
Constructs a new StringTokenizer
for the parameter string using
whitespace as the delimiter. The returnDelimiters
flag is set to
false
.
string | the string to be tokenized. |
---|
Constructs a new StringTokenizer
for the parameter string using
the specified delimiters. The returnDelimiters
flag is set to
false
. If delimiters
is null
, this constructor
doesn't throw an Exception
, but later calls to some methods might
throw a NullPointerException
.
string | the string to be tokenized. |
---|---|
delimiters | the delimiters to use. |
Constructs a new StringTokenizer
for the parameter string using
the specified delimiters, returning the delimiters as tokens if the
parameter returnDelimiters
is true
. If delimiters
is null this constructor doesn't throw an Exception
, but later
calls to some methods might throw a NullPointerException
.
string | the string to be tokenized. |
---|---|
delimiters | the delimiters to use. |
returnDelimiters | true to return each delimiter as a token.
|
Returns the number of unprocessed tokens remaining in the string.
Exception
will result from a call to nextToken()
.
Returns true
if unprocessed tokens remain. This method is
implemented in order to satisfy the Enumeration
interface.
true
if unprocessed tokens remain.
Returns true
if unprocessed tokens remain.
true
if unprocessed tokens remain.
Returns the next token in the string as an Object
. This method is
implemented in order to satisfy the Enumeration
interface.
Object
NoSuchElementException | if no tokens remain. |
---|
Returns the next token in the string as a String
. The delimiters
used are changed to the specified delimiters.
delims | the new delimiters to use. |
---|
String
.NoSuchElementException | if no tokens remain. |
---|
Returns the next token in the string as a String
.
String
.NoSuchElementException | if no tokens remain. |
---|