|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IntCollection
A collection of int
values.
IntCollectionCollection
,
CollectionIntCollection
Method Summary | |
---|---|
boolean |
add(int element)
Ensures that I contain the specified element (optional operation). |
boolean |
addAll(IntCollection c)
Adds all of the elements in the
specified collection to me (optional operation). |
void |
clear()
Removes all my elements (optional operation). |
boolean |
contains(int element)
Returns true iff I contain
the specified element. |
boolean |
containsAll(IntCollection c)
Returns true iff I contain
all of the elements in the given collection. |
boolean |
isEmpty()
Returns true iff I contain no elements. |
IntIterator |
iterator()
Returns an iterator over all my elements. |
boolean |
removeAll(IntCollection c)
Removes all of my elements that are contained in the specified collection (optional operation). |
boolean |
removeElement(int element)
Removes a single occurrence of the specified element (optional operation). |
boolean |
retainAll(IntCollection c)
Removes all of my elements that are not contained in the specified collection (optional operation). |
int |
size()
Returns the number of elements I contain. |
int[] |
toArray()
Returns an array containing all of my elements. |
int[] |
toArray(int[] a)
Returns an array containing all of my elements, using the given array if it is large enough. |
Method Detail |
---|
boolean add(int element)
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.
element
- the value whose presence within me is to be ensured
true
iff I changed as a result of this call
java.lang.UnsupportedOperationException
- when this operation is not
supported
java.lang.IllegalArgumentException
- may be thrown if some aspect of the
specified element prevents it from being added to meboolean addAll(IntCollection c)
Adds
all of the elements in the
specified collection to me (optional operation).
c
- the collection of elements whose presence within me is to
be ensured
true
iff I changed as a result of this call
java.lang.UnsupportedOperationException
- when this operation is not
supported
java.lang.IllegalArgumentException
- may be thrown if some aspect of some
specified element prevents it from being added to mevoid clear()
empty
after this
method successfully returns.
java.lang.UnsupportedOperationException
- when this operation is not
supportedboolean contains(int element)
true
iff I contain
the specified element.
element
- the value whose presence within me is to be tested
true
iff I contain the specified elementboolean containsAll(IntCollection c)
true
iff I contain
all of the elements in the given collection.
c
- the collection of elements whose presence within me is to
be tested
true
iff I contain the all the specified elementsboolean isEmpty()
true
iff I contain no elements.
true
iff I contain no elements.IntIterator iterator()
iterator
over all my elements.
This base interface places no constraints on the order
in which the elements are returned by the returned iterator.
iterator
over all my elements.boolean removeAll(IntCollection c)
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 call
java.lang.UnsupportedOperationException
- when this operation is not
supportedboolean removeElement(int element)
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 call
java.lang.UnsupportedOperationException
- when this operation is not
supportedboolean retainAll(IntCollection c)
c
- the collection of elements to retain
true
iff I changed as a result
of this call
java.lang.UnsupportedOperationException
- when this operation is not
supportedint size()
int[] toArray()
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.
int[] toArray(int[] a)
iterator
,
the returned array will contain elements in the
same order.
a
- 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 |