Class StringSplitter

java.lang.Object
  |
  +--StringSplitter

All Implemented Interfaces:

java.util.Enumeration

public class StringSplitter

extends java.lang.Object

implements java.util.Enumeration

(#)StringSplitter.java

Version:

Behaves much like StringTokenizer except that delimiter is used as whole as a delimiter instead of single delim characters, and the 'null space' between two delimiters is honored by default e.g: delimiter = "@-@" string = "one@-@@-@two@-@three@four-five@-@" StringTokenizer -> "one" "two" "three" "four" "five" StringSplitter -> "one" "" "two" "three@four-five" "" or StringSplitter -> "one" "two" "three@four-five"

Author:

Holger Pfaff

Constructor Summary

StringSplitter(java.lang.String string, java.lang.String delimiter)
Construct a new StringSplitter.

StringSplitter(java.lang.String string, java.lang.String delimiter, boolean splitNull)
Construct a new StringSplitter.

Method Summary

int	getNextPosition(int pos) Return index of next position within string. return -1 for none
boolean	hasMoreElements() Same as hasMoreTokens().
boolean	hasMoreTokens() Tests if there are more tokens/splitter available from this string.
boolean	hasMoreTokens(int pos) Tests if there are more tokens/splitter available from this string.
java.lang.Object	nextElement() Same as nextToken().
java.lang.String	nextToken() Returns the next token available from this string or null
java.lang.String	remainingString() Returns the remaining String of this string or null
java.lang.String[]	toArray() Utility method to convert this splitter to a String array.
java.lang.String	toString(java.lang.String delimiter) Utility method to convert this splitter to a new String using delimiter as separator.
java.util.Vector	toVector() Utility method to convert this splitter to a Vector of Strings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StringSplitter

public StringSplitter(java.lang.String string,
                      java.lang.String delimiter)

Construct a new StringSplitter. null strings will be handled as empty ones.

Parameters:

string - string to split.

delimiter - string to use as delimiter.

StringSplitter

public StringSplitter(java.lang.String string,
                      java.lang.String delimiter,
                      boolean splitNull)

Construct a new StringSplitter. null strings will be handled as empty ones.

Parameters:

string - string to split.

delimiter - string to use as delimiter.

splitNull - handle strings with zero length between to delims as separate tokens?.

Method Detail

hasMoreTokens

public boolean hasMoreTokens()

Tests if there are more tokens/splitter available from this string.

hasMoreTokens

public boolean hasMoreTokens(int pos)

Tests if there are more tokens/splitter available from this string.

Parameters:

pos - position to start from.

getNextPosition

public int getNextPosition(int pos)

Return index of next position within string. return -1 for none

Parameters:

pos - position to start from.

nextToken

public java.lang.String nextToken()

Returns the next token available from this string or null

remainingString

public java.lang.String remainingString()

Returns the remaining String of this string or null

hasMoreElements

public boolean hasMoreElements()

Same as hasMoreTokens(). Implements Enumeration interface.

Specified by:

hasMoreElements in interface java.util.Enumeration

nextElement

public java.lang.Object nextElement()

Same as nextToken(). Implements Enumeration interface.

Specified by:

nextElement in interface java.util.Enumeration

toArray

public java.lang.String[] toArray()

Utility method to convert this splitter to a String array. Requires Util.class

toVector

public java.util.Vector toVector()

Utility method to convert this splitter to a Vector of Strings. Requires Util.class

toString

public java.lang.String toString(java.lang.String delimiter)

Utility method to convert this splitter to a new String using delimiter as separator. Requires Util.class

Parameters:

delimiter - string to use as separator.