ucar.ma2

Interface StructureDataIterator

All Known Implementing Classes:

ArrayStructure.ArrayStructureIterator, CDMArraySequence.SDI, SequenceIterator, StructureDataIteratorIndexed, StructureDataIteratorLimited, StructureDataIteratorLinked, StructureDataIteratorMediated

public interface StructureDataIterator

An iterator over StructureData. Make sure that you call finish(). Best to put in a try/finally block like:

try {
  while (iter.hasNext())
   process(iter.next());
 } finally {
   iter.finish();
 }

Since:

Feb 23, 2008

Method Summary

Modifier and Type	Method and Description
void	finish() Make sure that the iterator is complete, and recover resources.
int	getCurrentRecno()
boolean	hasNext() See if theres more StructureData in the iteration.
StructureData	next() Get the next StructureData in the iteration.
StructureDataIterator	reset() Start the iteration over again.
void	setBufferSize(int bytes) Hint to use this much memory in buffering the iteration.

Method Detail

hasNext

boolean hasNext()
         throws java.io.IOException

See if theres more StructureData in the iteration. You must always call this before calling next().

Returns:

true if more records are available

Throws:

java.io.IOException - on read error

next

StructureData next()
            throws java.io.IOException

Get the next StructureData in the iteration.

Returns:

next StructureData record.

Throws:

java.io.IOException - on read error

setBufferSize

void setBufferSize(int bytes)

Hint to use this much memory in buffering the iteration. No guarentee that it will be used by the implementation.

Parameters:

bytes - amount of memory in bytes

reset

StructureDataIterator reset()

Start the iteration over again.

Returns:

a new or reset iterator.

getCurrentRecno

int getCurrentRecno()

finish

void finish()

Make sure that the iterator is complete, and recover resources. Best to put in a try/finally block like:

 try {
   while (iter.hasNext())
    process(iter.next());
  } finally {
    iter.finish();
  }