org.dmfs.rfc3986.utils

Class Split

java.lang.Object

org.dmfs.iterators.AbstractBaseIterator<java.lang.CharSequence>

org.dmfs.rfc3986.utils.Split

All Implemented Interfaces:

java.util.Iterator<java.lang.CharSequence>

public final class Split
extends org.dmfs.iterators.AbstractBaseIterator<java.lang.CharSequence>

An Iterator that iterates the elements of a CharSequence of a comma (or other character) separated value list .

Example:

 
        Iterator<CharSequence> i = new Split("a, b,def,123", ',');
        i.next(); // returns "a"
        i.next(); // returns " b"
        i.next(); // returns "def"
        i.next(); // returns "123"
        i.hasNext(); // false
 
 

Iterating an empty CharSequence or a CharSequence without (unquoted) separators will return exactly one element.

Example:

 
        Iterator<CharSequence> i = new Split("", ',');
        i.next(); // returns ""
        i.hasNext(); // false
 
 

TODO: replace with the implementation in Iterators once it has been released

Constructor Summary

Constructors

Constructor and Description
Split(java.lang.CharSequence value, char separator) Creates an Iterator that iterates all segments of the given CharSequence which are separated by the given separator.
Split(java.lang.CharSequence value, char separator, int maxSplits) Creates an Iterator that iterates all segments of the given CharSequence which are separated by the given separator.

Method Summary

Modifier and Type	Method and Description
boolean	hasNext()
java.lang.CharSequence	next()

Methods inherited from class org.dmfs.iterators.AbstractBaseIterator

equals, hashCode, remove

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

Split

public Split(java.lang.CharSequence value,
             char separator)

Creates an Iterator that iterates all segments of the given CharSequence which are separated by the given separator.

Parameters:

value - The CharSequence that contains a list of values.

separator - The separator that separates the values.

Split

public Split(java.lang.CharSequence value,
             char separator,
             int maxSplits)

Creates an Iterator that iterates all segments of the given CharSequence which are separated by the given separator.

Parameters:

value - The CharSequence that contains a separated list of values.

separator - The separator to scan for.

maxSplits - The maximum number of splits to perform. The iterator will return at most this number +1 elements (the last iterated element containing the rest of the CharSequence.

Method Detail

hasNext

public boolean hasNext()

next

public java.lang.CharSequence next()