|
| |
|
| java.util.AbstractList
 bak.pcj.adapter.CharListToListAdapter
| CharListToListAdapter | | public class CharListToListAdapter extends AbstractList (Code) | | This class represents adapters of char lists to Java Collection Framework lists.
The adapter is implemented as a wrapper around a primitive list. Thus,
changes to the underlying list are reflected by this
list and vice versa.
See Also: bak.pcj.list.CharList
See Also: java.util.List
author:
Søren Bak
version:
1.2 20-08-2003 22:58
since:
1.0 |
| Field Summary | |
| protected CharList | list
The underlying primitive list. |
| Constructor Summary | |
| public | CharListToListAdapter(CharList list)
Creates a new adaption of a collection of char
values to a Java Collections Framework collection. |
| Method Summary | |
| public void | add(int index, Object o)
Adds an element to this list at a specified index. | | public boolean | addAll(int index, Collection c)
Adds all the elements of a specified collection to
this list starting at a specified index. | | public Object | get(int index)
Returns the element at a specified position in this list.
The returned value will always be of class
Character Character .
Parameters:
index - the position of the element to return. | | public ListIterator | listIterator(int index)
Returns a list iterator over this list, starting from a
specified index.
Parameters:
index - the index at which to begin the iteration. | | public Object | remove(int index)
Removes the element at a specified index in this list. | | public boolean | removeAll(Collection c)
Removes all the elements of a specified collection from
this list. | | public boolean | retainAll(Collection c)
Retains only the elements of a specified collection in
this list. | | public Object | set(int index, Object o)
Sets a specified element to a new value. | | public int | size()
Returns the number of elements in this list. |
| CharListToListAdapter | | public CharListToListAdapter(CharList list)(Code) | | Creates a new adaption of a collection of char
values to a Java Collections Framework collection.
Parameters:
list - the underlying primitive collection.
throws:
NullPointerException - if collection is null. |
| add | | public void add(int index, Object o)(Code) | | Adds an element to this list at a specified index. All
elements from the specified index and forward are pushed
to their successor's indices. The element is added to
the underlying collection.
Parameters:
index - the index at which to add the element. Ifindex == size() the element is appendedto this list.
Parameters:
o - the element to add to this list.
throws:
UnsupportedOperationException - if the operation is not supported by thislist.
throws:
IndexOutOfBoundsException - if index does not denote a valid insertionposition (valid: 0 - size()).
throws:
IllegalArgumentException - if o is null.
throws:
ClassCastException - if o is not of class Character Character. |
| addAll | | public boolean addAll(int index, Collection c)(Code) | | Adds all the elements of a specified collection to
this list starting at a specified index. The elements are
inserted in the specified collection's iteration order.
All elements from the specified index and forward are pushed
to their successors' indices (c.size() indices).
All elements are added to the underlying list.
This method is only overridden to work
around a bug in
AbstractList AbstractList ,
which does not throw a
NullPointerException NullPointerException when the
argument is null and the list is empty.
Parameters:
index - the index at which to insert the elements ofthe specified collection. Ifindex == size() the elements are appendedto this list.
Parameters:
c - the collection whose elements to add to thislist. true if this list was modifiedas a result of adding the elements of c;returns false otherwise.
throws:
UnsupportedOperationException - if the operation is not supported by theunderlying list.
throws:
NullPointerException - if c is null.
throws:
IndexOutOfBoundsException - if index does not denote a valid insertionposition (valid: 0 - size()).
throws:
IllegalArgumentException - if an element of c is null.
throws:
ClassCastException - if an element of c is not of classCharacter Character. |
| get | | public Object get(int index)(Code) | | Returns the element at a specified position in this list.
The returned value will always be of class
Character Character .
Parameters:
index - the position of the element to return. the element at the specified position.
throws:
IndexOutOfBoundsException - if index does not denote a valid indexin this list. |
| listIterator | | public ListIterator listIterator(int index)(Code) | | Returns a list iterator over this list, starting from a
specified index.
Parameters:
index - the index at which to begin the iteration. a list iterator over this list.
throws:
IndexOutOfBoundsException - if index does not denote a validiteration position (valid: 0 - size()). |
| remove | | public Object remove(int index)(Code) | | Removes the element at a specified index in this list. All
elements following the removed element are pushed to their
predecessor's indices. The element is removed from the
underlying collection.
Parameters:
index - the index of the element to remove.
throws:
UnsupportedOperationException - if the operation is not supported by the underlyinglist.
throws:
IndexOutOfBoundsException - if index does not denote a validelement position (valid: 0 - size()-1). |
| removeAll | | public boolean removeAll(Collection c)(Code) | | Removes all the elements of a specified collection from
this list. The elements are removed from the
underlying list.
This method is only overridden to work
around a bug in
AbstractList AbstractList ,
which does not throw a
NullPointerException NullPointerException when the
argument is null and the list is empty. The
bug is inherited from
AbstractCollection AbstractCollection .
Parameters:
c - the collection whose elements to remove from thiscollection. true if this list was modifiedas a result of removing the elements of c;returns false otherwise.
throws:
UnsupportedOperationException - if the operation is not supported by the underlyingcollection.
throws:
NullPointerException - if c is null. |
| retainAll | | public boolean retainAll(Collection c)(Code) | | Retains only the elements of a specified collection in
this list. The elements are removed from the
underlying list.
This method is only overridden to work
around a bug in
AbstractList AbstractList ,
which does not throw a
NullPointerException NullPointerException when the
argument is null and the list is empty. The
bug is inherited from
AbstractCollection AbstractCollection .
Parameters:
c - the collection whose elements to retain in thiscollection. true if this list was modifiedas a result of removing the elements not containedin c;returns false otherwise.
throws:
UnsupportedOperationException - if the operation is not supported by the underlyinglist.
throws:
NullPointerException - if c is null. |
| set | | public Object set(int index, Object o)(Code) | | Sets a specified element to a new value. The corresponding
element of the underlying list is set to the unwrapped value.
Parameters:
index - the index of the element whose value to set.
Parameters:
o - the new value of the specified element. the previous value of the element.
throws:
UnsupportedOperationException - if the operation is not supported by the underlyinglist.
throws:
IndexOutOfBoundsException - if index does not denote a validelement position (valid: 0 - size()-1).
throws:
IllegalArgumentException - if o is null.
throws:
ClassCastException - if o is not of class Character Character. |
| size | | public int size()(Code) | | Returns the number of elements in this list. The
number of elements is the same as that of the underlying
list.
the number of elements in this list. |
| Fields inherited from java.util.AbstractList | protected transient int modCount(Code)(Java Doc)
|
|
|
|