public interface ReadingList extends OsidList
Like all OsidLists,
ReadingList
provides
a means for accessing Reading
elements sequentially either
one at a time or many at a time. Examples:
while (rl.hasNext()) { Reading reading = rl.getNextReading(); }or
while (rl.hasNext()) { Reading[] readings = rl.getNextReadings(rl.available()); }
Modifier and Type | Method and Description |
---|---|
Reading |
getNextReading()
Gets the next
Reading in this list. |
Reading[] |
getNextReadings(long n)
Gets the next set of
Reading elements in this list. |
Reading getNextReading() throws OperationFailedException
Reading
in this list. Reading
in this list. The
hasNext()
method should be used to test that a next
Reading
is available before calling this
method.IllegalStateException
- no more elements available in
this listOperationFailedException
- unable to complete requestmandatory
- This method must be implemented. Reading[] getNextReadings(long n) throws OperationFailedException
Reading
elements in this list. The
specified amount must be less than or equal to the return from
available().
n
- the number of Reading
elements requested
which must be less than or equal to available()
Reading
elements.
The length of the array is less than or equal to the number
specified.IllegalStateException
- no more elements available in
this listOperationFailedException
- unable to complete requestmandatory
- This method must be implemented.