Skip to content

Most visited

Recently visited

navigation
Added in API level 1

StringTokenizer

public class StringTokenizer
extends Object implements Enumeration<Object>

java.lang.Object
   ↳ java.util.StringTokenizer


Breaks a string into tokens; new code should probably use split(String).

 // Legacy code:
 StringTokenizer st = new StringTokenizer("a:b:c", ":");
 while (st.hasMoreTokens()) {
     System.err.println(st.nextToken());
 }

 // New code:
 for (String token : "a:b:c".split(":")) {
     System.err.println(token);
 }
 

Summary

Public constructors

StringTokenizer(String string)

Constructs a new StringTokenizer for the parameter string using whitespace as the delimiter.

StringTokenizer(String string, String delimiters)

Constructs a new StringTokenizer for the parameter string using the specified delimiters.

StringTokenizer(String string, String delimiters, boolean returnDelimiters)

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

int countTokens()

Returns the number of unprocessed tokens remaining in the string.

boolean hasMoreElements()

Returns true if unprocessed tokens remain.

boolean hasMoreTokens()

Returns true if unprocessed tokens remain.

Object nextElement()

Returns the next token in the string as an Object.

String nextToken(String delims)

Returns the next token in the string as a String.

String nextToken()

Returns the next token in the string as a String.

Inherited methods

From class java.lang.Object
From interface java.util.Enumeration

Public constructors

StringTokenizer

Added in API level 1
StringTokenizer (String string)

Constructs a new StringTokenizer for the parameter string using whitespace as the delimiter. The returnDelimiters flag is set to false.

Parameters
string String: the string to be tokenized.

StringTokenizer

Added in API level 1
StringTokenizer (String string, 
                String delimiters)

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.

Parameters
string String: the string to be tokenized.
delimiters String: the delimiters to use.

StringTokenizer

Added in API level 1
StringTokenizer (String string, 
                String delimiters, 
                boolean returnDelimiters)

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.

Parameters
string String: the string to be tokenized.
delimiters String: the delimiters to use.
returnDelimiters boolean: true to return each delimiter as a token.

Public methods

countTokens

Added in API level 1
int countTokens ()

Returns the number of unprocessed tokens remaining in the string.

Returns
int number of tokens that can be retreived before an Exception will result from a call to nextToken().

hasMoreElements

Added in API level 1
boolean hasMoreElements ()

Returns true if unprocessed tokens remain. This method is implemented in order to satisfy the Enumeration interface.

Returns
boolean true if unprocessed tokens remain.

hasMoreTokens

Added in API level 1
boolean hasMoreTokens ()

Returns true if unprocessed tokens remain.

Returns
boolean true if unprocessed tokens remain.

nextElement

Added in API level 1
Object nextElement ()

Returns the next token in the string as an Object. This method is implemented in order to satisfy the Enumeration interface.

Returns
Object next token in the string as an Object
Throws
NoSuchElementException if no tokens remain.

nextToken

Added in API level 1
String nextToken (String delims)

Returns the next token in the string as a String. The delimiters used are changed to the specified delimiters.

Parameters
delims String: the new delimiters to use.
Returns
String next token in the string as a String.
Throws
NoSuchElementException if no tokens remain.

nextToken

Added in API level 1
String nextToken ()

Returns the next token in the string as a String.

Returns
String next token in the string as a String.
Throws
NoSuchElementException if no tokens remain.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.