Keymapper Iterators ( Keymapper::const_iterator )

Definition

Instances of type it iterate over the elements of a keymapper. They behave similar like const-pointers to AgdKey. A keymapper K provides functions to retrieve iterators pointing to the first or last element of K. We say an iterator of keymapper K is valid iff it points to an element of K. Derefferencing is only allowed for valid iterators.

#include < AGD/Keymapper.h >

Creation

Keymapper::const_iterator	it	creates an invalid iterator it.
Keymapper::const_iterator	it(const Keymapper& mapper)
		creates an iterator it pointing to the first element of mapper.
Keymapper::const_iterator	it(const const_iterator& iter)
		creates an iterator identical to iter.

Operations

bool	it.valid()	returns true iff it is valid, i.e., points to an element.
bool	it == const const_iterator& iter
		returns true iff it and iter point to the same element.
bool	it != const const_iterator& iter
		returns true iff it and iter point to different elements.
const_iterator &	it = const const_iterator& iter
		assigns iter to it.
const AgdKey &	*it	returns the element to which it points.
const AgdKey *	it->	returns the address of the element to which it points.
const_iterator &	++it	increments and returns it.
const_iterator	it++	increments it and returns its previous value.
const_iterator &	-it	decrements and returns it.
const_iterator	it-	decrements it and returns its previous value.