|
|||||||||||
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.
Constructor Summary | |
ListByteList(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(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 Collection |
getCollection()
|
protected 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. |
String |
toString()
|
static ByteList |
wrap(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 |
Constructor Detail |
public ListByteList(List list)
ByteList
wrapping
the specified List
.
wrap(java.util.List)
Method Detail |
public static ByteList wrap(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 List getList()
public void add(int index, byte element)
ByteList
add
in interface ByteList
index
- the index at which to insert the elementelement
- the value to insertpublic boolean addAll(int index, ByteCollection collection)
ByteList
iterator
.
addAll
in interface ByteList
index
- 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 ByteList
index
- the index of the element to return
public int indexOf(byte element)
ByteList
-1
if I do not contain
the element.
indexOf
in interface ByteList
element
- the element to search for
-1
if no such matching element can be foundpublic int lastIndexOf(byte element)
ByteList
lastIndexOf
in interface ByteList
element
- 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 ByteList
public ByteListIterator listIterator(int index)
wraps
the
ByteList
returned by my underlying
ByteListIterator
,
if any.
listIterator
in interface ByteList
public byte removeElementAt(int index)
ByteList
removeElementAt
in interface ByteList
index
- the index of the element to remove
public byte set(int index, byte element)
ByteList
set
in interface ByteList
index
- the index of the element to changeelement
- the value to be stored at the specified position
public ByteList subList(int fromIndex, int toIndex)
ByteList
ByteList
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 ByteList
fromIndex
- 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(Object obj)
ByteList
true
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 ByteList
public int hashCode()
ByteList
ByteList
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 Byte
s.
hashCode
in interface ByteList
protected final Collection getCollection()
public boolean add(byte element)
ByteCollection
true
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 ByteCollection
element
- the value whose presence within me is to be ensured
true
iff I changed as a result of this callpublic boolean addAll(ByteCollection c)
ByteCollection
Adds
all of the elements in the
specified collection to me (optional operation).
addAll
in interface ByteCollection
c
- the collection of elements whose presence within me is to
be ensured
true
iff I changed as a result of this callpublic void clear()
ByteCollection
empty
after this
method successfully returns.
clear
in interface ByteCollection
public boolean contains(byte element)
ByteCollection
true
iff I contain
the specified element.
contains
in interface ByteCollection
element
- the value whose presence within me is to be tested
true
iff I contain the specified elementpublic boolean containsAll(ByteCollection c)
ByteCollection
true
iff I contain
all of the elements in the given collection.
containsAll
in interface ByteCollection
c
- the collection of elements whose presence within me is to
be tested
true
iff I contain the all the specified elementspublic String toString()
public boolean isEmpty()
ByteCollection
true
iff I contain no elements.
isEmpty
in interface ByteCollection
true
iff I contain no elements.public ByteIterator iterator()
wraps
the
Iterator
returned by my underlying
Collection
,
if any.
iterator
in interface ByteCollection
iterator
over all my elements.public boolean removeElement(byte element)
ByteCollection
removeElement
in interface ByteCollection
element
- 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 ByteCollection
c
- 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 ByteCollection
c
- the collection of elements to retain
true
iff I changed as a result
of this callpublic int size()
ByteCollection
size
in interface ByteCollection
public byte[] toArray()
ByteCollection
size
.
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 ByteCollection
public byte[] toArray(byte[] dest)
ByteCollection
iterator
,
the returned array will contain elements in the
same order.
toArray
in interface ByteCollection
dest
- 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 |