com.github.mangstadt.vinnie.io

Class VObjectPropertyValues.SemiStructuredValueIterator

java.lang.Object

com.github.mangstadt.vinnie.io.VObjectPropertyValues.SemiStructuredValueIterator

Enclosing class:

VObjectPropertyValues

public static class VObjectPropertyValues.SemiStructuredValueIterator
extends Object

Helper class for iterating over the values in a "semi-structured" property value.

Semi-structured values contain multiple values separate by semicolons. Unlike structured values, each value cannot have their own comma-delimited list of sub-values. The order that the values are in usually matters.

Example:

 String value = "one;two;;three";
 
 SemiStructuredValueIterator it = new SemiStructuredValueIterator(value);
 assertEquals("one", it.next());
 assertEquals("two", it.next());
 assertNull(it.next());
 assertEquals("three", it.next());
 assertFalse(it.hasNext());
 
 it = new SemiStructuredValueIterator(value, 2);
 assertEquals("one", it.next());
 assertEquals("two;;three", it.next());
 assertFalse(it.hasNext());
 

Constructor Summary

Constructors

Constructor and Description
SemiStructuredValueIterator(String value) Constructs a new semi-structured value iterator.
SemiStructuredValueIterator(String value, int limit) Constructs a new semi-structured value iterator.

Method Summary

Modifier and Type	Method and Description
boolean	hasNext() Determines if there are any more values left.
String	next() Gets the next value.

Methods inherited from class java.lang.Object

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

Constructor Detail

SemiStructuredValueIterator

public SemiStructuredValueIterator(String value)

Constructs a new semi-structured value iterator.

Parameters:

value - the value to parse

SemiStructuredValueIterator

public SemiStructuredValueIterator(String value,
                                   int limit)

Constructs a new semi-structured value iterator.

Parameters:

value - the value to parse

limit - the number of values to parse, or -1 to parse all values

Method Detail

next

public String next()

Gets the next value.

Returns:

the next value or null if the value is empty or null if there are no more values

hasNext

public boolean hasNext()

Determines if there are any more values left.

Returns:

true if there are more values, false if not