com.t_arn.lib.util

Class taVector

java.lang.Object

java.util.Vector

eve.util.mVector

com.t_arn.lib.util.taVector

All Implemented Interfaces:

eve.data.DataUnit, eve.util.Copyable, java.io.Serializable, java.lang.Cloneable, java.lang.Comparable, java.util.Collection

public class taVector
extends eve.util.mVector

This class extends eve.util.mVector
A taVector containing Strings can be loaded from a text file and also be saved to a text file.
The taVector can also be sorted and has a find method with a Comparator

Since:

16.09.07 - 06.02.18

Author:

Tom Arn, www.t-arn.com

See Also:

mVector, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Constructor Summary

Constructors

Constructor and Description
taVector() Creates a new taVector
taVector(java.util.Vector v) Creates a new taVector from a java.util.Vector

Method Summary

Modifier and Type	Method and Description
java.lang.Object	find(java.lang.Object searchFor, java.util.Comparator comp) Finds an element of the taVector by using the compare method of a Comparator.
java.lang.Throwable	getLastError() Returns the last error that occurred
static java.lang.String	getVersion() Returns the version of this class.
boolean	load(java.lang.String filename) Calls load (filename, -1);
boolean	load(java.lang.String filename, int maxElements) Clears the taVector and loads Strings from a UTT-8 file into it.
boolean	save(java.lang.String filename) Calls save (filename, -1)
boolean	save(java.lang.String filename, int maxElements) Writes the taVector as Strings to a UTF-8 file.
void	sort(boolean bSortIgnoreCase) Sorts the elements of this taVector by using a Comparator that treats the elements as Strings.
void	sort(java.util.Comparator comp) Sorts this taVector using the supplied Comparator Returns nothing, sets lastError on error (see getLastError)

Methods inherited from class eve.util.mVector

add, add, addAll, addAll, addAll, addAll, addCopiesFrom, cacheAllElements, clear, compareTo, copied, copyCopiesFrom, copyFrom, copyInto, copyInto, del, find, get, getCopy, getCount, getFullCopy, getNew, insert, iterator, newVector, pop, push, size, toArray, toArray, toArray, toArray, toArray, toObjectArray, toString

Methods inherited from class java.util.Vector

add, addAll, addAll, addElement, capacity, clone, contains, containsAll, elementAt, elements, ensureCapacity, firstElement, indexOf, indexOf, insertElementAt, isEmpty, iterator, lastElement, lastIndexOf, lastIndexOf, remove, removeAll, removeAllElements, removeElement, removeElementAt, retainAll, setElementAt, setSize, size, trimToSize

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

equals, hashCode

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

taVector

public taVector()

Creates a new taVector

taVector

public taVector(java.util.Vector v)

Creates a new taVector from a java.util.Vector

Parameters:

v - The Vector to base taVector on

Method Detail

find

public java.lang.Object find(java.lang.Object searchFor,
                             java.util.Comparator comp)

Finds an element of the taVector by using the compare method of a Comparator. Object one of the Comparator's compare method is the taVector element, Object two is the searchFor Object.

Parameters:

searchFor - The Object that we are looking for

comp - The Comparator to be used to find the taVector element

Returns:

The found taVector element or null

getLastError

public java.lang.Throwable getLastError()

Returns the last error that occurred

Returns:

last error or null when no error

load

public boolean load(java.lang.String filename)

Calls load (filename, -1);

Parameters:

filename - Text file from where to read

Returns:

returns true if operation was successful, false otherwise (see getLastError)

load

public boolean load(java.lang.String filename,
                    int maxElements)

Clears the taVector and loads Strings from a UTT-8 file into it. Every line can contain ^n for newline.

Parameters:

filename - Text file from where to read

maxElements - Maximum elements to read. -1 means all elements.

Returns:

returns true if operation was successful, false otherwise (see getLastError)

getVersion

public static java.lang.String getVersion()

Returns the version of this class.

Returns:

Returns the version

save

public boolean save(java.lang.String filename)

Calls save (filename, -1)

Parameters:

filename - Text file where to write to

Returns:

returns true if operation was successful, false otherwise (see getLastError)

save

public boolean save(java.lang.String filename,
                    int maxElements)

Writes the taVector as Strings to a UTF-8 file. Every newline is saved as ^n

Parameters:

filename - Text file where to write to

maxElements - Maximum elements to write. -1 means all elements.

Returns:

returns true if operation was successful, false otherwise (see getLastError)

sort

public void sort(boolean bSortIgnoreCase)

Sorts the elements of this taVector by using a Comparator that treats the elements as Strings. Returns nothing, sets lastError on error (see getLastError)

Parameters:

bSortIgnoreCase - if true the sort will be case-insensitve

sort

public void sort(java.util.Comparator comp)

Sorts this taVector using the supplied Comparator Returns nothing, sets lastError on error (see getLastError)

Parameters:

comp - Comperator to be used for sorting, when null sorts by natural order