jodd.util.collection

Class CharArrayList

java.lang.Object

jodd.util.collection.CharArrayList

public class CharArrayList
extends java.lang.Object

ArrayList of char primitives. For just buffering values, consider using FastCharBuffer.

Field Summary

Fields

Modifier and Type	Field and Description
static int	initialCapacity

Constructor Summary

Constructors

Constructor and Description
CharArrayList() Constructs an empty list with an initial capacity.
CharArrayList(char[] data) Constructs a list containing the elements of the specified array.
CharArrayList(int initialCapacity) Constructs an empty list with the specified initial capacity.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(char element) Appends the specified element to the end of this list.
void	add(int index, char element) Inserts the specified element at the specified position in this list.
void	addAll(char[] data) Appends all of the elements in the specified array to the end of this list.
void	addAll(int index, char[] data) Appends all of the elements in the specified array at the specified position in this list.
void	clear() Removes all of the elements from this list.
boolean	contains(char data) Returns true if this list contains the specified element.
void	ensureCapacity(int mincap) Increases the capacity of this ArrayList instance, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.
char	get(int index) Returns the element at the specified position in this list.
int	indexOf(char data) Searches for the first occurrence of the given argument.
boolean	isEmpty() Tests if this list has no elements.
int	lastIndexOf(char data) Returns the index of the last occurrence of the specified object in this list.
char	remove(int index) Removes the element at the specified position in this list.
void	removeRange(int fromIndex, int toIndex) Removes from this list all of the elements whose index is between fromIndex, inclusive and toIndex, exclusive.
char	set(int index, char element) Replaces the element at the specified position in this list with the specified element.
int	size() Returns the number of elements in this list.
char[]	toArray() Returns an array containing all of the elements in this list in the correct order.
void	trimToSize() Trims the capacity of this instance to be the list's current size.

Methods inherited from class java.lang.Object

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

Field Detail

initialCapacity

public static int initialCapacity

Constructor Detail

CharArrayList

public CharArrayList()

Constructs an empty list with an initial capacity.

CharArrayList

public CharArrayList(int initialCapacity)

Constructs an empty list with the specified initial capacity.

CharArrayList

public CharArrayList(char[] data)

Constructs a list containing the elements of the specified array. The list instance has an initial capacity of 110% the size of the specified array.

Method Detail

toArray

public char[] toArray()

Returns an array containing all of the elements in this list in the correct order.

get

public char get(int index)

Returns the element at the specified position in this list.

size

public int size()

Returns the number of elements in this list.

remove

public char remove(int index)

Removes the element at the specified position in this list. Shifts any subsequent elements to the left (subtracts one from their indices).

Parameters:

index - the index of the element to remove

Returns:

the value of the element that was removed

Throws:

java.lang.UnsupportedOperationException - when this operation is not supported

java.lang.IndexOutOfBoundsException - if the specified index is out of range

removeRange

public void removeRange(int fromIndex,
               int toIndex)

Removes from this list all of the elements whose index is between fromIndex, inclusive and toIndex, exclusive. Shifts any succeeding elements to the left (reduces their index).

set

public char set(int index,
       char element)

Replaces the element at the specified position in this list with the specified element.

Parameters:

index - the index of the element to change

element - the value to be stored at the specified position

Returns:

the value previously stored at the specified position

add

public void add(char element)

Appends the specified element to the end of this list.

add

public void add(int index,
       char element)

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

Parameters:

index - the index at which to insert the element

element - the value to insert

addAll

public void addAll(char[] data)

Appends all of the elements in the specified array to the end of this list.

addAll

public void addAll(int index,
          char[] data)

Appends all of the elements in the specified array at the specified position in this list.

clear

public void clear()

Removes all of the elements from this list. The list will be empty after this call returns.

contains

public boolean contains(char data)

Returns true if this list contains the specified element.

indexOf

public int indexOf(char data)

Searches for the first occurrence of the given argument.

lastIndexOf

public int lastIndexOf(char data)

Returns the index of the last occurrence of the specified object in this list.

isEmpty

public boolean isEmpty()

Tests if this list has no elements.

ensureCapacity

public void ensureCapacity(int mincap)

Increases the capacity of this ArrayList instance, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.

trimToSize

public void trimToSize()

Trims the capacity of this instance to be the list's current size. An application can use this operation to minimize the storage of some instance.