Qore Programming Language Reference Manual  1.12.0
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:

Public Member Methods

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 Methods 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");
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.