Qore::AbstractQuantifiedIterator Class Referenceabstract

This class defines an abstract interface for iterators where the size of the object being iterated is known in advance. More...

Inheritance diagram for Qore::AbstractQuantifiedIterator:
[legend]

## Public Member Functions

abstract bool | empty ()
| returns True if the object to iterate is empty; False if not More...
abstract bool | first ()
| returns True if on the first element More...
abstract bool | last ()
| returns True if on the last element More...
Public Member Functions inherited from Qore::AbstractIterator
abstract auto | getValue ()
| returns the current value More...
abstract bool | next ()
| Moves the current position to the next element; returns False if there are no more elements. More...
abstract bool | valid ()
| returns True if the iterator is currently pointing at a valid element, False if not More...

## Detailed Description

This class defines an abstract interface for iterators where the size of the object being iterated is known in advance.

## Member Function Documentation

## empty()

abstract bool Qore::AbstractQuantifiedIterator::empty | ( |  | ) |

pure virtual

returns True if the object to iterate is empty; False if not

Returns
  True if the object to iterate is empty; False if not

Example:
  if (i.empty())
  printf("object is empty\n");
  Qore::printf
  string printf(string fmt,...)
  Outputs the string passed to standard output, using the first argument as a format string; does not e...

Implemented in Qore::ListIterator, Qore::ListHashIterator, Qore::HashListIterator, and Qore::HashIterator.

## first()

abstract bool Qore::AbstractQuantifiedIterator::first | ( |  | ) |

pure virtual

returns True if on the first element

Returns
  True if on the first element

Example:
  while (i.next()) {
  if (i.first())
  printf("START:\n");
  }

Implemented in Qore::ObjectReverseIterator, Qore::ListReverseIterator, Qore::ListIterator, Qore::ListHashReverseIterator, Qore::ListHashIterator, Qore::HashReverseIterator, Qore::HashListReverseIterator, Qore::HashListIterator, and Qore::HashIterator.

## last()

abstract bool Qore::AbstractQuantifiedIterator::last | ( |  | ) |

pure virtual

returns True if on the last element

Returns
  True if on the last element

Example:
  while (i.next()) {
  if (i.last())
  printf("END.\n");
  }

Implemented in Qore::ObjectReverseIterator, Qore::ListReverseIterator, Qore::ListIterator, Qore::ListHashReverseIterator, Qore::ListHashIterator, Qore::HashReverseIterator, Qore::HashListReverseIterator, Qore::HashListIterator, and Qore::HashIterator.