la.util

Class Series.Separator

java.lang.Object

la.util.Series

la.util.Series.Separator

Enclosing class:

Series

public static class Series.Separator
extends Series

A Series of "comma"-separated variables (CSV) as Chars (strings) out of a String, s. In fact the separator can be any character. The terminology "variable" is used in statistics and refers to a column of values in a spreadsheet (.csv, data-set), say. You may also be interested in Series.Lines.

Nested Class Summary

Nested classes/interfaces inherited from class la.util.Series

Series.Discrete, Series.Int, Series.Lines, Series.Range, Series.Separator

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	s The String being scanned for variables.
char	separator The separator between variables, often but not always ','.
boolean	trimHead To trim white space from heads and tails, or not?
boolean	trimTail To trim white space from heads and tails, or not?

Fields inherited from class la.util.Series

EMPTY

Constructor Summary

Constructors

Constructor and Description
Separator(boolean trimHead, boolean trimTail, char separator, java.lang.String s) Note, if separator =' ', trimming makes no sense.
Separator(char separator, java.lang.String s) Construct a Separator with a given separator character.
Separator(java.lang.String s) Construct a Separator with the most common choice, separator = ','.

Method Summary

Modifier and Type	Method and Description
void	advance() Advance to the next variable, if any.
Value.Chars	elt() Return the current element, if there is one, but do not Series.advance().
boolean	hasSome() Is there at least a current element, (Series.elt())? Also see Series.hasNone().
int	position() What position in the Series are we at (starting at zero)? If Series.hasNone(), the series was finite and position() is now its length.
java.lang.String	toString() Return a short String description of 'this' Series, say for use in debugging.

Methods inherited from class la.util.Series

advance, advanceTo, append, asList, error, exhaust, fromInts, fromVector, hasNone, main, merge, merge, singleton, values, wt

Methods inherited from class java.lang.Object

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

Field Detail

s

public final java.lang.String s

The String being scanned for variables.

separator

public final char separator

The separator between variables, often but not always ','.

trimHead

public final boolean trimHead

To trim white space from heads and tails, or not?

trimTail

public final boolean trimTail

To trim white space from heads and tails, or not?

Constructor Detail

Separator

public Separator(java.lang.String s)

Construct a Separator with the most common choice, separator = ','.

Separator

public Separator(char separator,
                 java.lang.String s)

Construct a Separator with a given separator character. Note, trimHead = trimTail = true.

Separator

public Separator(boolean trimHead,
                 boolean trimTail,
                 char separator,
                 java.lang.String s)

Note, if separator =' ', trimming makes no sense.

Method Detail

position

public int position()

Description copied from class: Series

What position in the Series are we at (starting at zero)? If Series.hasNone(), the series was finite and position() is now its length.

Specified by:

position in class Series

hasSome

public boolean hasSome()

Description copied from class: Series

Is there at least a current element, (Series.elt())? Also see Series.hasNone().

Specified by:

hasSome in class Series

elt

public Value.Chars elt()

Description copied from class: Series

Return the current element, if there is one, but do not Series.advance(). Should throw an Exception if hasNone().

Specified by:

elt in class Series

advance

public void advance()

Advance to the next variable, if any.

Specified by:

advance in class Series

toString

public java.lang.String toString()

Description copied from class: Series

Return a short String description of 'this' Series, say for use in debugging.

Overrides:

toString in class Series