|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.commons.collections.primitives.adapters.AbstractCollectionByteCollection
org.apache.commons.collections.primitives.adapters.AbstractListByteList
org.apache.commons.collections.primitives.adapters.ListByteList
Adapts a Number-valued List
to the ByteList interface.
List
implementation in the "obvious" way.
| Field Summary | |
private java.util.List |
_list
|
| Constructor Summary | |
ListByteList(java.util.List list)
Creates an ByteList wrapping
the specified List. |
|
| Method Summary | |
boolean |
add(byte element)
Appends the specified element to the end of me (optional operation). |
void |
add(int index,
byte element)
Inserts the specified element at the specified position (optional operation). |
boolean |
addAll(ByteCollection c)
Adds all of the elements in the
specified collection to me (optional operation). |
boolean |
addAll(int index,
ByteCollection collection)
Inserts all of the elements in the specified collection into me, at the specified position (optional operation). |
void |
clear()
Removes all my elements (optional operation). |
boolean |
contains(byte element)
Returns true iff I contain
the specified element. |
boolean |
containsAll(ByteCollection c)
Returns true iff I contain
all of the elements in the given collection. |
boolean |
equals(java.lang.Object obj)
Returns true iff that is an ByteList
that contains the same elements in the same order as me. |
byte |
get(int index)
Returns the value of the element at the specified position within me. |
protected java.util.Collection |
getCollection()
|
protected java.util.List |
getList()
|
int |
hashCode()
Returns my hash code. |
int |
indexOf(byte element)
Returns the index of the first occurrence of the specified element within me, or -1 if I do not contain
the element. |
boolean |
isEmpty()
Returns true iff I contain no elements. |
ByteIterator |
iterator()
wraps the
Iterator
returned by my underlying
Collection,
if any. |
int |
lastIndexOf(byte element)
Returns the index of the last occurrence of the specified element within me, or -1 if I do not contain the element. |
ByteListIterator |
listIterator()
wraps the
ByteList
returned by my underlying
ByteListIterator,
if any. |
ByteListIterator |
listIterator(int index)
wraps the
ByteList
returned by my underlying
ByteListIterator,
if any. |
boolean |
removeAll(ByteCollection c)
Removes all of my elements that are contained in the specified collection (optional operation). |
boolean |
removeElement(byte element)
Removes a single occurrence of the specified element (optional operation). |
byte |
removeElementAt(int index)
Removes the element at the specified position in (optional operation). |
boolean |
retainAll(ByteCollection c)
Removes all of my elements that are not contained in the specified collection (optional operation). |
byte |
set(int index,
byte element)
Replaces the element at the specified position in me with the specified element (optional operation). |
int |
size()
Returns the number of elements I contain. |
ByteList |
subList(int fromIndex,
int toIndex)
Returns a view of the elements within me between the specified fromIndex, inclusive, and toIndex, exclusive. |
byte[] |
toArray()
Returns an array containing all of my elements. |
byte[] |
toArray(byte[] dest)
Returns an array containing all of my elements, using the given array if it is large enough. |
java.lang.String |
toString()
|
static ByteList |
wrap(java.util.List list)
Create an ByteList wrapping
the specified List. |
| Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface org.apache.commons.collections.primitives.ByteList |
add, iterator |
| Methods inherited from interface org.apache.commons.collections.primitives.ByteCollection |
addAll, clear, contains, containsAll, isEmpty, removeAll, removeElement, retainAll, size, toArray, toArray |
| Field Detail |
private java.util.List _list
| Constructor Detail |
public ListByteList(java.util.List list)
ByteList wrapping
the specified List.
wrap(java.util.List)| Method Detail |
public static ByteList wrap(java.util.List list)
ByteList wrapping
the specified List. When
the given list is null,
returns null.
list - the (possibly null)
List to wrap
ByteList wrapping the given
list, or null when list is
null.protected java.util.List getList()
getList in class AbstractListByteList
public void add(int index,
byte element)
ByteList
add in interface ByteListindex - the index at which to insert the elementelement - the value to insert
public boolean addAll(int index,
ByteCollection collection)
ByteListiterator.
addAll in interface ByteListindex - the index at which to insert the first element from
the specified collectioncollection - the ByteCollection of elements to add
true iff I changed as a result of this callpublic byte get(int index)
ByteList
get in interface ByteListindex - the index of the element to return
public int indexOf(byte element)
ByteList-1 if I do not contain
the element.
indexOf in interface ByteListelement - the element to search for
-1 if no such matching element can be foundpublic int lastIndexOf(byte element)
ByteList
lastIndexOf in interface ByteListelement - the element to search for
-1 if no such matching element can be foundpublic ByteListIterator listIterator()
wraps the
ByteList
returned by my underlying
ByteListIterator,
if any.
listIterator in interface ByteListpublic ByteListIterator listIterator(int index)
wraps the
ByteList
returned by my underlying
ByteListIterator,
if any.
listIterator in interface ByteListpublic byte removeElementAt(int index)
ByteList
removeElementAt in interface ByteListindex - the index of the element to remove
public byte set(int index,
byte element)
ByteList
set in interface ByteListindex - the index of the element to changeelement - the value to be stored at the specified position
public ByteList subList(int fromIndex,
int toIndex)
ByteListByteList
is backed by me, so that any changes in
the returned list are reflected in me, and vice-versa.
The returned list supports all of the optional operations
that I support.
Note that when fromIndex == toIndex,
the returned list is initially empty, and when
fromIndex == 0 && toIndex == size()
the returned list is my "improper" sublist, containing all my elements.
The semantics of the returned list become undefined
if I am structurally modified in any way other than
via the returned list.
subList in interface ByteListfromIndex - the smallest index (inclusive) in me that appears in
the returned listtoIndex - the largest index (exclusive) in me that appears in the
returned list
public boolean equals(java.lang.Object obj)
ByteListtrue iff that is an ByteList
that contains the same elements in the same order as me.
In other words, returns true iff that is
an ByteList that has the same size as me,
and for which the elements returned by its
iterator are equal (==) to
the corresponding elements within me.
(This contract ensures that this method works properly across
different implementations of the ByteList interface.)
equals in interface ByteListpublic int hashCode()
ByteListByteList is defined to be the
result of the following calculation:
int hash = 1;
for(ByteIterator iter = iterator(); iter.hasNext(); ) {
byte value = iter.next();
hash = 31*hash + (int)(value ^ (value >>> 32));
}
This contract ensures that this method is consistent with
equals and with the
hashCode
method of a List of Bytes.
hashCode in interface ByteListprotected final java.util.Collection getCollection()
getCollection in class AbstractCollectionByteCollectionpublic boolean add(byte element)
ByteCollectiontrue
iff I changed as a result of this call.
If a collection refuses to add the specified
element for any reason other than that it already contains
the element, it must throw an exception (rather than
simply returning false). This preserves the invariant
that a collection always contains the specified element after
this call returns.
add in interface ByteCollectionelement - the value whose presence within me is to be ensured
true iff I changed as a result of this callpublic boolean addAll(ByteCollection c)
ByteCollectionAdds all of the elements in the
specified collection to me (optional operation).
addAll in interface ByteCollectionc - the collection of elements whose presence within me is to
be ensured
true iff I changed as a result of this callpublic void clear()
ByteCollectionempty after this
method successfully returns.
clear in interface ByteCollectionpublic boolean contains(byte element)
ByteCollectiontrue iff I contain
the specified element.
contains in interface ByteCollectionelement - the value whose presence within me is to be tested
true iff I contain the specified elementpublic boolean containsAll(ByteCollection c)
ByteCollectiontrue iff I contain
all of the elements in the given collection.
containsAll in interface ByteCollectionc - the collection of elements whose presence within me is to
be tested
true iff I contain the all the specified elementspublic java.lang.String toString()
public boolean isEmpty()
ByteCollectiontrue iff I contain no elements.
isEmpty in interface ByteCollectiontrue iff I contain no elements.public ByteIterator iterator()
wraps the
Iterator
returned by my underlying
Collection,
if any.
iterator in interface ByteCollectioniterator over all my elements.public boolean removeElement(byte element)
ByteCollection
removeElement in interface ByteCollectionelement - the element to remove, if present
true iff I contained the specified element,
in other words, iff I changed as a result of this callpublic boolean removeAll(ByteCollection c)
ByteCollection
removeAll in interface ByteCollectionc - the collection of elements to remove
true iff I contained the at least one of the
specified elements, in other words, returns true
iff I changed as a result of this callpublic boolean retainAll(ByteCollection c)
ByteCollection
retainAll in interface ByteCollectionc - the collection of elements to retain
true iff I changed as a result
of this callpublic int size()
ByteCollection
size in interface ByteCollectionpublic byte[] toArray()
ByteCollectionsize.
The returned array will be independent of me,
so that callers may modify that
returned array without modifying this collection.
When I guarantee the order in which
elements are returned by an iterator,
the returned array will contain elements in the
same order.
toArray in interface ByteCollectionpublic byte[] toArray(byte[] dest)
ByteCollectioniterator,
the returned array will contain elements in the
same order.
toArray in interface ByteCollectiondest - an array that may be used to contain the elements
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||