to top
Android APIs
public class

StringTokenizer

extends Object
implements Enumeration<E>
java.lang.Object
   ↳ java.util.StringTokenizer

Class Overview

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.
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.util.Enumeration

Public Constructors

public StringTokenizer (String string)

Added in API level 1

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

Parameters
string the string to be tokenized.

public StringTokenizer (String string, String delimiters)

Added in API level 1

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 the string to be tokenized.
delimiters the delimiters to use.

public StringTokenizer (String string, String delimiters, boolean returnDelimiters)

Added in API level 1

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 the string to be tokenized.
delimiters the delimiters to use.
returnDelimiters true to return each delimiter as a token.

Public Methods

public int countTokens ()

Added in API level 1

Returns the number of unprocessed tokens remaining in the string.

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

public boolean hasMoreElements ()

Added in API level 1

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

Returns
  • true if unprocessed tokens remain.

public boolean hasMoreTokens ()

Added in API level 1

Returns true if unprocessed tokens remain.

Returns
  • true if unprocessed tokens remain.

public Object nextElement ()

Added in API level 1

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

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

public String nextToken (String delims)

Added in API level 1

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

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

public String nextToken ()

Added in API level 1

Returns the next token in the string as a String.

Returns
  • next token in the string as a String.
Throws
NoSuchElementException if no tokens remain.
No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.