triana.types.util

Class StringVector

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList

triana.types.util.StringVector

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess

Direct Known Subclasses:

StringSplitter

public class StringVector
extends java.util.ArrayList

StringVector is a class that extends ArrayList in a convenient way to deal only with strings. It provides has shortcut names for the methods $elementAt^ (=$at^), $firstElement^ (=$first^) and $lastElement^ (=$last^).

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
StringVector() Constructs an empty vector.
StringVector(int initialCapacity) Constructs an empty StringVector with the specified storage capacity.
StringVector(java.lang.String str) Constructs a StringVector from a String by splitting the String by new line and adding them one by one to the StringVector.

Method Summary

Methods

Modifier and Type	Method and Description
void	addElement(java.lang.Object el)
void	append(StringVector s) Adds the elements of the given StringVector to the end of the present one, by reference.
java.lang.String	at(int index) Returns the String element at the specified index.
StringVector	copy()
void	copyInto(java.lang.Object[] objects) copies this string vector into the object array
java.lang.Object	elementAt(int el)
java.util.Enumeration	elements()
java.lang.String	first() Returns the first element of the sequence.
int	indexOf(java.lang.Object el, int s)
java.lang.Object	last() Returns the last element of the sequence.
void	removeAllElements()
void	removeElementAt(int i)
void	setElementAt(java.lang.String str, int i)
void	sort() Sorts the string vector into ascending alpabetical order.
java.lang.String	toAString()
double[]	toDoubles()
int[]	toInts()
java.lang.String	toNewLineString()

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeRange, retainAll, set, size, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Constructor Detail

StringVector

public StringVector(int initialCapacity)

Constructs an empty StringVector with the specified storage capacity.

Parameters:

initialCapacity - the initial storage capacity of the vector

StringVector

public StringVector(java.lang.String str)
             throws java.lang.Exception

Constructs a StringVector from a String by splitting the String by new line and adding them one by one to the StringVector.

Throws:

java.lang.Exception

StringVector

public StringVector()

Constructs an empty vector.

Method Detail

at

public final java.lang.String at(int index)

Returns the String element at the specified index.

Parameters:

index - the index of the desired element

Throws:

java.lang.ArrayIndexOutOfBoundsException - If an invalid index was given.

first

public final java.lang.String first()

Returns the first element of the sequence.

Throws:

java.util.NoSuchElementException - If the sequence is empty.

last

public final java.lang.Object last()

Returns the last element of the sequence.

Throws:

java.util.NoSuchElementException - If the sequence is empty.

toAString

public final java.lang.String toAString()

Returns:

a string representation of this vector in the form :-
el1 el2 el3 el4 ..... el(size-1)

toNewLineString

public final java.lang.String toNewLineString()

Returns:

a string representation of this vector in the form :-
el1
el2
el3
el4
..... el(size-1)

toDoubles

public final double[] toDoubles()

Returns:

a double array representation of this vector. Only useful when you know that the StringVector contains a a list of Strings which you know are all doubles.

el1 el2 el3 el4 ..... el(size-1) \n

toInts

public final int[] toInts()

Returns:

an int array representation of this vector. Only useful when you know that the StringVector contains a a list of Strings which you know are all integers.

el1 el2 el3 el4 ..... el(size-1) \n

copy

public StringVector copy()

Returns:

a StringVector that is a proper copy (not just a reference) of the current StringVector.

copyInto

public void copyInto(java.lang.Object[] objects)

copies this string vector into the object array

elements

public java.util.Enumeration elements()

sort

public void sort()

Sorts the string vector into ascending alpabetical order.

append

public void append(StringVector s)

Adds the elements of the given StringVector to the end of the present one, by reference.

Parameters:

s - The StringVector to be appended

addElement

public void addElement(java.lang.Object el)

elementAt

public java.lang.Object elementAt(int el)

removeElementAt

public void removeElementAt(int i)

setElementAt

public void setElementAt(java.lang.String str,
                int i)

indexOf

public int indexOf(java.lang.Object el,
          int s)

removeAllElements

public void removeAllElements()