xdev.util

Class XdevList<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.Vector<E>

xdev.util.XdevList<E>

Type Parameters:

E - type of the list's entries.

All Implemented Interfaces:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess, Copyable<XdevList<E>>

public class XdevList<E>
extends Vector<E>
implements Copyable<XdevList<E>>

The standard List in XDEV. Based on Vector.

Since:

2.0

Author:

XDEV Software

See Also:

List, Vector, Serialized Form

Field Summary

Fields inherited from class java.util.Vector

capacityIncrement, elementCount, elementData

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
XdevList() Constructs an empty XdevList so that its internal data array has size 10 and its standard capacity increment is zero.
XdevList(Collection<? extends E> c) Constructs a XdevList containing the elements of the specified collection, in the order they are returned by the collection's iterator.
XdevList(int initialCapacity) Constructs an empty XdevList with the specified initial capacity and with its capacity increment equal to zero.
XdevList(int initialCapacity, int capacityIncrement) Constructs an empty XdevList with the specified initial capacity and capacity increment.
XdevList(V... values) Constructs a XdevList containing the elements of the specified values, in the order they are given to this method.

Method Summary

Modifier and Type	Method and Description
XdevList<E>	clone() Returns a field-for-field copy of this instance.
XdevList<E>	copy() Creates a (defensive) copy of this XdevList.
int	deleteDoubleValues() Deletes all duplicate values from this XdevList.
String	getSeparator() Return the separator of this XdevList.
void	insert(int index, E value) Inserts the specified element value at the specified position in this XdevList.
Object	removeObject(Object object) Removes the first occurrence of the specified element in this XdevList If the XdevList does not contain the element, it is unchanged.
void	setSeparator(String separator) Sets the separator of this XdevList.
String	toString()
String	toString(String separator) Returns a String representation of all elements of this XdevList separated by the specified separator.

Methods inherited from class java.util.Vector

add, add, addAll, addAll, addElement, capacity, clear, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, forEach, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, iterator, lastElement, lastIndexOf, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeIf, removeRange, replaceAll, retainAll, set, setElementAt, setSize, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, stream

Constructor Detail

XdevList

public XdevList()

Constructs an empty XdevList so that its internal data array has size 10 and its standard capacity increment is zero.

XdevList

public XdevList(V... values)

Constructs a XdevList containing the elements of the specified values, in the order they are given to this method.

Type Parameters:

V - type of the values to be added

Parameters:

values - the values to be placed into this XdevList

XdevList

public XdevList(int initialCapacity)
         throws IllegalArgumentException

Constructs an empty XdevList with the specified initial capacity and with its capacity increment equal to zero.

Parameters:

initialCapacity - the initial capacity of the XdevList

Throws:

IllegalArgumentException - if the specified initial capacity is negative

XdevList

public XdevList(Collection<? extends E> c)
         throws NullPointerException

Constructs a XdevList containing the elements of the specified collection, in the order they are returned by the collection's iterator.

Parameters:

c - the collection whose elements are to be placed into this XdevList

Throws:

NullPointerException - if the specified collection is null

XdevList

public XdevList(int initialCapacity,
                int capacityIncrement)
         throws IllegalArgumentException

Constructs an empty XdevList with the specified initial capacity and capacity increment.

Parameters:

initialCapacity - the initial capacity of the XdevList

capacityIncrement - the amount by which the capacity is increased when the XdevList overflows

Throws:

IllegalArgumentException - if the specified initial capacity is negative

Method Detail

deleteDoubleValues

public int deleteDoubleValues()

Deletes all duplicate values from this XdevList. A value is delete if there is a other value in this XdevList where

 value1.equals(value2) == true
 

Returns:

the number of deletes values

insert

public void insert(int index,
                   E value)
            throws ArrayIndexOutOfBoundsException

Inserts the specified element value at the specified position in this XdevList. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

Parameters:

index - index at which the specified element is to be inserted

value - element to be inserted

Throws:

ArrayIndexOutOfBoundsException - if the index is out of range ( index < 0 || index > size())

removeObject

public Object removeObject(Object object)

Removes the first occurrence of the specified element in this XdevList If the XdevList does not contain the element, it is unchanged. More formally, removes the element with the lowest index i such that (object==null ? get(i)==null : object.equals(get(i))) (if such an element exists).

Parameters:

object - element to be removed from this XdevList, if present

Returns:

the removed object if the XdevList contained the specified element; otherwise null

getSeparator

public String getSeparator()

Return the separator of this XdevList.

Returns:

the separator of this XdevList.

setSeparator

public void setSeparator(String separator)

Sets the separator of this XdevList.

Parameters:

separator - the separator of this XdevList.

toString

public String toString()

Overrides:

toString in class Vector<E>

toString

public String toString(String separator)

Returns a String representation of all elements of this XdevList separated by the specified separator.

Parameters:

separator - String to separated the list elements.

Returns:

a String representation of all elements of this XdevList separated by the specified separator.

copy

public XdevList<E> copy()

Creates a (defensive) copy of this XdevList.

Returns:

a (defensive) copy of this XdevList.

clone

public XdevList<E> clone()

Returns a field-for-field copy of this instance.

Specified by:

clone in interface Copyable<XdevList<E>>

Overrides:

clone in class Vector<E>

Returns:

a field-for-field copy of this instance.