org.pepstock.charba.client.commons

Class JsStringArrayList

java.lang.Object

org.pepstock.charba.client.commons.JsStringArrayList

All Implemented Interfaces:

java.lang.Iterable<java.lang.String>, java.util.Collection<java.lang.String>, java.util.List<java.lang.String>

public final class JsStringArrayList
extends java.lang.Object
implements java.util.List<java.lang.String>

An ordered collection (also known as a sequence). The user of this interface has precise control over where in the list each element is inserted.
The user can access elements by their integer index (position in the list), and search for elements in the list.
This implementation uses a GWT JsArray as backend to store objects (strings).

Author:

Andrea "Stock" Stocchero

See Also:

JsArrayStringImpl

Constructor Summary

Constructors

Constructor and Description
JsStringArrayList() Creates an empty list

Method Summary

Modifier and Type	Method and Description
void	add(int index, java.lang.String 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).
boolean	add(java.lang.String e) Appends the specified element to the end of this list
boolean	addAll(java.util.Collection<? extends java.lang.String> c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's iterator
boolean	addAll(int index, java.util.Collection<? extends java.lang.String> c) Inserts all of the elements in the specified collection into this list at the specified position. Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices).
void	addAll(java.lang.String... values) Loads an array of elements into the list
void	clear() Removes all of the elements from this list.
boolean	contains(java.lang.Object o) Returns true if this list contains the specified element.
boolean	containsAll(java.util.Collection<?> c) Returns true if this list contains all of the elements of the specified collection.
java.lang.String	get(int index) Returns the element at the specified position in this list.
int	indexOf(java.lang.Object o) Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
boolean	isEmpty() Returns true if this list contains no elements
java.util.Iterator<java.lang.String>	iterator() Returns an iterator over the elements in this list in proper sequence.
int	lastIndexOf(java.lang.Object o) Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
java.util.ListIterator<java.lang.String>	listIterator() Returns a list iterator over the elements in this list
java.util.ListIterator<java.lang.String>	listIterator(int index) Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list. The specified index indicates the first element that would be returned by an initial call to next. An initial call to previous would return the element with the specified index minus one.
java.lang.String	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).
boolean	remove(java.lang.Object o) Removes the first occurrence of the specified element from this list, if it is present.
boolean	removeAll(java.util.Collection<?> c) Removes from this list all of its elements that are contained in the specified collection.
boolean	retainAll(java.util.Collection<?> c) Retains only the elements in this list that are contained in the specified collection. In other words, removes from this list all of its elements that are not contained in the specified collection.
java.lang.String	set(int index, java.lang.String 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.
java.util.List<java.lang.String>	subList(int fromIndex, int toIndex) Not implemented
java.lang.Object[]	toArray() Not implemented
<T> T[]	toArray(T[] a) Not implemented
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

equals, hashCode, replaceAll, sort, spliterator

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

JsStringArrayList

public JsStringArrayList()

Creates an empty list

Method Detail

addAll

public void addAll(java.lang.String... values)

Loads an array of elements into the list

Parameters:

values - an array of elements to be loaded

size

public int size()

Returns the number of elements in this list.

Specified by:

size in interface java.util.Collection<java.lang.String>

Specified by:

size in interface java.util.List<java.lang.String>

isEmpty

public boolean isEmpty()

Returns true if this list contains no elements

Specified by:

isEmpty in interface java.util.Collection<java.lang.String>

Specified by:

isEmpty in interface java.util.List<java.lang.String>

contains

public boolean contains(java.lang.Object o)

Returns true if this list contains the specified element.

Specified by:

contains in interface java.util.Collection<java.lang.String>

Specified by:

contains in interface java.util.List<java.lang.String>

iterator

public java.util.Iterator<java.lang.String> iterator()

Returns an iterator over the elements in this list in proper sequence.

Specified by:

iterator in interface java.lang.Iterable<java.lang.String>

Specified by:

iterator in interface java.util.Collection<java.lang.String>

Specified by:

iterator in interface java.util.List<java.lang.String>

toArray

public java.lang.Object[] toArray()

Not implemented

Specified by:

toArray in interface java.util.Collection<java.lang.String>

Specified by:

toArray in interface java.util.List<java.lang.String>

toArray

public <T> T[] toArray(T[] a)

Not implemented

Specified by:

toArray in interface java.util.Collection<java.lang.String>

Specified by:

toArray in interface java.util.List<java.lang.String>

add

public boolean add(java.lang.String e)

Appends the specified element to the end of this list

Specified by:

add in interface java.util.Collection<java.lang.String>

Specified by:

add in interface java.util.List<java.lang.String>

remove

public boolean remove(java.lang.Object o)

Removes the first occurrence of the specified element from this list, if it is present. If this list does not contain the element, it is unchanged.

Specified by:

remove in interface java.util.Collection<java.lang.String>

Specified by:

remove in interface java.util.List<java.lang.String>

containsAll

public boolean containsAll(java.util.Collection<?> c)

Returns true if this list contains all of the elements of the specified collection.

Specified by:

containsAll in interface java.util.Collection<java.lang.String>

Specified by:

containsAll in interface java.util.List<java.lang.String>

addAll

public boolean addAll(java.util.Collection<? extends java.lang.String> c)

Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's iterator

Specified by:

addAll in interface java.util.Collection<java.lang.String>

Specified by:

addAll in interface java.util.List<java.lang.String>

addAll

public boolean addAll(int index,
                      java.util.Collection<? extends java.lang.String> c)

Inserts all of the elements in the specified collection into this list at the specified position.
Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices).

Specified by:

addAll in interface java.util.List<java.lang.String>

removeAll

public boolean removeAll(java.util.Collection<?> c)

Removes from this list all of its elements that are contained in the specified collection.

Specified by:

removeAll in interface java.util.Collection<java.lang.String>

Specified by:

removeAll in interface java.util.List<java.lang.String>

retainAll

public boolean retainAll(java.util.Collection<?> c)

Retains only the elements in this list that are contained in the specified collection.
In other words, removes from this list all of its elements that are not contained in the specified collection.

Specified by:

retainAll in interface java.util.Collection<java.lang.String>

Specified by:

retainAll in interface java.util.List<java.lang.String>

clear

public void clear()

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

Specified by:

clear in interface java.util.Collection<java.lang.String>

Specified by:

clear in interface java.util.List<java.lang.String>

get

public java.lang.String get(int index)

Returns the element at the specified position in this list. If index out of range, returns null

Specified by:

get in interface java.util.List<java.lang.String>

set

public java.lang.String set(int index,
                            java.lang.String element)

Replaces the element at the specified position in this list with the specified element. If index out of range, returns null

Specified by:

set in interface java.util.List<java.lang.String>

add

public void add(int index,
                java.lang.String 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).

Specified by:

add in interface java.util.List<java.lang.String>

remove

public java.lang.String 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). Returns the element that was removed from the list.

Specified by:

remove in interface java.util.List<java.lang.String>

indexOf

public int indexOf(java.lang.Object o)

Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.

Specified by:

indexOf in interface java.util.List<java.lang.String>

lastIndexOf

public int lastIndexOf(java.lang.Object o)

Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.

Specified by:

lastIndexOf in interface java.util.List<java.lang.String>

listIterator

public java.util.ListIterator<java.lang.String> listIterator()

Returns a list iterator over the elements in this list

Specified by:

listIterator in interface java.util.List<java.lang.String>

listIterator

public java.util.ListIterator<java.lang.String> listIterator(int index)

Returns a list iterator over the elements in this list (in proper sequence), starting at the specified position in the list.
The specified index indicates the first element that would be returned by an initial call to next.
An initial call to previous would return the element with the specified index minus one.

Specified by:

listIterator in interface java.util.List<java.lang.String>

subList

public java.util.List<java.lang.String> subList(int fromIndex,
                                                int toIndex)

Not implemented

Specified by:

subList in interface java.util.List<java.lang.String>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object