Forward iterator for JMap. More...

#include <maps.h>

Inheritance diagram for original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator:

Collaboration diagram for original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator:

Public Member Functions
	Iterator (skipListNode *cur)
	Constructs iterator pointing to specific skip list node.

	Iterator (const Iterator &other)
	Copy constructor.

Iterator &	operator= (const Iterator &other)
	Copy assignment operator.

Iterator *	clone () const override
	Creates a copy of this iterator.

std::string	className () const override
	Gets iterator class name.

void	operator+= (integer steps) const override
	Advances iterator by steps.

void	operator-= (integer steps) const override
	Not supported (throws unSupportedMethodError)

integer	operator- (const iterator< couple< const K_TYPE, V_TYPE > > &other) const override
	Calculates distance between iterators.

bool	hasNext () const override
	Checks if more elements exist in forward direction.

bool	hasPrev () const override
	Not supported (throws unSupportedMethodError)

bool	atPrev (const iterator< couple< const K_TYPE, V_TYPE > > *other) const override
	Checks if other is previous to this.

bool	atNext (const iterator< couple< const K_TYPE, V_TYPE > > *other) const override
	Checks if other is next to this.

void	next () const override
	Moves to next element.

void	prev () const override
	Not supported (throws unSupportedMethodError)

Iterator *	getPrev () const override
	Not supported (throws unSupportedMethodError)

couple< const K_TYPE, V_TYPE > &	get () override
	Gets current element (non-const)

couple< const K_TYPE, V_TYPE >	get () const override
	Gets current element (const)

void	set (const couple< const K_TYPE, V_TYPE > &data) override
	Not supported (throws unSupportedMethodError)

bool	isValid () const override
	Checks if iterator is valid.

Public Member Functions inherited from original::baseIterator< couple< const K_TYPE, V_TYPE > >
	~baseIterator () override=default
	Virtual destructor for proper cleanup of derived objects.

Public Member Functions inherited from original::iterator< TYPE >
TYPE &	operator* ()
	Dereferences the iterator to get the element.

TYPE	operator* () const
	Dereferences the iterator to get a copy of the element.

void	operator++ () const
	Moves the iterator forward by one position.

void	operator++ (int postfix) const
	Moves the iterator forward by one position (postfix).

void	operator-- () const
	Moves the iterator backward by one position.

void	operator-- (int postfix) const
	Moves the iterator backward by one position (postfix).

integer	compareTo (const iterator &other) const override
	Compares two iterators to determine their relative positions.

virtual integer	operator- (const iterator &other) const =0
	Returns the distance between this iterator and another iterator.

	operator bool () const
	Checks if the iterator is valid (i.e., points to a valid element).

virtual bool	atPrev (const iterator *other) const =0
	Checks if this iterator is positioned at the previous element.

virtual bool	atNext (const iterator *other) const =0
	Checks if this iterator is positioned at the next element.

bool	atPrev (const iterator &other) const
	Checks if this iterator is positioned at the previous element.

bool	atNext (const iterator &other) const
	Checks if this iterator is positioned at the next element.

virtual iterator *	getNext () const
	Returns a new iterator pointing to the next element.

virtual TYPE	getElem () const
	Returns a copy of the element.

virtual void	set (const TYPE &data)=0
	Sets the element pointed to by the iterator.

bool	equal (const iterator *other) const
	Checks if two iterators are equal.

bool	equal (const iterator &other) const
	Checks if two iterators are equal.

std::string	toString (bool enter) const override
	Returns a string representation of the iterator.

	~iterator () override=default
	Virtual destructor for proper cleanup of derived objects.

Public Member Functions inherited from original::printable
	operator std::string () const
	Explicit conversion to std::string.

	operator const char * () const
	Explicit conversion to C-style string.

const char *	toCString (bool enter) const
	Direct C-string access with formatting control.

template<typename TYPE >
auto	formatString (const TYPE &t) -> std::string

template<typename TYPE >
auto	formatCString (const TYPE &t) -> const char *

template<typename TYPE >
auto	formatEnum (const TYPE &t) -> std::string

template<typename TYPE >
auto	formatString (TYPE *const &ptr) -> std::string

Public Member Functions inherited from original::cloneable
	~cloneable () override=default
	Virtual destructor for cloneable.

Public Member Functions inherited from original::baseCloneable< cloneable >
virtual	~baseCloneable ()=default
	Virtual destructor for baseCloneable.

Public Member Functions inherited from original::comparable< iterator< TYPE > >
bool	operator== (const iterator< TYPE > &other) const
	Checks if the current object is equal to another.

bool	operator!= (const iterator< TYPE > &other) const
	Checks if the current object is not equal to another.

bool	operator< (const iterator< TYPE > &other) const
	Checks if the current object is less than another.

bool	operator> (const iterator< TYPE > &other) const
	Checks if the current object is greater than another.

bool	operator<= (const iterator< TYPE > &other) const
	Checks if the current object is less than or equal to another.

bool	operator>= (const iterator< TYPE > &other) const
	Checks if the current object is greater than or equal to another.

virtual	~comparable ()=default
	Virtual destructor for proper cleanup of derived objects.

Friends
class	JMap

Additional Inherited Members
Static Public Member Functions inherited from original::printable
template<typename TYPE >
static std::string	formatString (const TYPE &t)
	Universal value-to-string conversion with type-specific formatting.

template<Printable TYPE>
static std::string	formatString (const TYPE &t)
	Specialization for types deriving from printable.

template<EnumType TYPE>
static std::string	formatString (const TYPE &t)
	Specialization for enum types with type-safe formatting.

template<typename TYPE >
static std::string	formatString (TYPE *const &ptr)
	Pointer-specific formatting with null safety.

template<typename TYPE >
static const char *	formatCString (const TYPE &t)
	C-string cache for temporary usage with static storage.

template<typename TYPE >
static std::string	formatEnum (const TYPE &t)
	Enum formatting utility with underlying value extraction.

template<>
auto	formatString (const char &t) -> std::string

template<>
auto	formatString (const bool &t) -> std::string

template<>
auto	formatString (const char *const &ptr) -> std::string

Protected Member Functions inherited from original::skipList< K_TYPE, V_TYPE, ALLOC, Compare >::Iterator
	Iterator (skipListNode *cur=nullptr)
	Constructs iterator.

	Iterator (const Iterator &other)
	Copy constructor.

Iterator &	operator= (const Iterator &other)
	Copy assignment operator.

bool	hasNext () const
	Checks if more elements exist forward.

void	next () const
	Moves to next element.

Iterator *	clone () const
	Creates a copy of this iterator.

void	operator+= (integer steps) const
	Advances iterator by steps.

integer	operator- (const Iterator &other) const
	Calculates distance between iterators.

couple< const K_TYPE, V_TYPE > &	get ()
	Gets current element (non-const)

couple< const K_TYPE, V_TYPE >	get () const
	Gets current element (const)

bool	isValid () const
	Checks if iterator is valid.

Protected Member Functions inherited from original::iterator< TYPE >
virtual bool	equalPtr (const iterator *other) const =0
	Checks if two iterators point to the same underlying element.

Protected Member Functions inherited from original::cloneable
	cloneable ()=default
	Default constructor for cloneable.

Protected Member Functions inherited from original::baseCloneable< cloneable >
	baseCloneable ()=default
	Default constructor for baseCloneable.

Static Protected Member Functions inherited from original::skipList< K_TYPE, V_TYPE, ALLOC, Compare >::Iterator
static integer	ptrDistance (const Iterator start, const Iterator end)
	Calculates distance between two iterators.

Protected Attributes inherited from original::skipList< K_TYPE, V_TYPE, ALLOC, Compare >::Iterator
skipListNode *	cur_
	Current node pointer.

Detailed Description

template<typename K_TYPE, typename V_TYPE, typename Compare = increaseComparator<K_TYPE>, typename ALLOC = allocator<couple<const K_TYPE, V_TYPE>>>
class original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator

Forward iterator for JMap.

Provides iteration over JMap elements while maintaining:

Sorted traversal order (according to comparator)
Safe invalidation detection
Const-correct access

Iterator Characteristics:

Forward iteration only (throws on reverse operations)
Invalidates on container modification
Lightweight copy semantics

Constructor & Destructor Documentation

◆ Iterator() [1/2]

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::Iterator ( skipListNode * cur )

explicit

Constructs iterator pointing to specific skip list node.

Parameters

cur	Current node pointer

Note: Internal constructor, not meant for direct use

◆ Iterator() [2/2]

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::Iterator ( const Iterator & other )

Copy constructor.

Parameters

other Iterator to copy

Member Function Documentation

◆ atNext()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

bool original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::atNext ( const iterator< couple< const K_TYPE, V_TYPE > > * other ) const

override

Checks if other is next to this.

Parameters

other Iterator to check

Returns: true if other is next

◆ atPrev()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

bool original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::atPrev ( const iterator< couple< const K_TYPE, V_TYPE > > * other ) const

override

Checks if other is previous to this.

Parameters

other Iterator to check

Returns: true if other is previous

◆ className()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

std::string original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::className ( ) const

overridevirtual

Gets iterator class name.

Returns: "JMap::Iterator"

Reimplemented from original::iterator< TYPE >.

◆ clone()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator * original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::clone ( ) const

overridevirtual

Creates a copy of this iterator.

Returns: New iterator instance

Implements original::baseIterator< couple< const K_TYPE, V_TYPE > >.

◆ get() [1/2]

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::couple< const K_TYPE, V_TYPE > original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::get ( ) const

overridevirtual

Gets current element (const)

Returns: Copy of current key-value pair

Implements original::iterator< TYPE >.

◆ get() [2/2]

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::couple< const K_TYPE, V_TYPE > & original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::get ( )

overridevirtual

Gets current element (non-const)

Returns: Reference to current key-value pair

Implements original::iterator< TYPE >.

◆ getPrev()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator * original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::getPrev ( ) const

overridevirtual

Not supported (throws unSupportedMethodError)

Implements original::iterator< TYPE >.

◆ hasNext()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

bool original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::hasNext ( ) const

overridevirtual

Checks if more elements exist in forward direction.

Returns: true if more elements available

Implements original::iterator< TYPE >.

◆ hasPrev()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

bool original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::hasPrev ( ) const

overridevirtual

Not supported (throws unSupportedMethodError)

Implements original::iterator< TYPE >.

◆ isValid()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

bool original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::isValid ( ) const

overridevirtual

Checks if iterator is valid.

Returns: true if iterator points to valid element

Implements original::iterator< TYPE >.

◆ next()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

void original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::next ( ) const

overridevirtual

Moves to next element.

Implements original::iterator< TYPE >.

◆ operator+=()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

void original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::operator+= ( integer steps ) const

overridevirtual

Advances iterator by steps.

Parameters

steps Number of positions to advance

Implements original::iterator< TYPE >.

◆ operator-()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::integer original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::operator- ( const iterator< couple< const K_TYPE, V_TYPE > > & other ) const

override

Calculates distance between iterators.

Parameters

other Iterator to calculate distance to

Returns: Distance between iterators

Note: Returns max/min integer values if iterators are not compatible

◆ operator-=()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

void original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::operator-= ( integer steps ) const

overridevirtual

Not supported (throws unSupportedMethodError)

Implements original::iterator< TYPE >.

◆ operator=()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator & original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::operator= ( const Iterator & other )

Copy assignment operator.

Parameters

other Iterator to copy

Returns: Reference to this iterator

◆ prev()

template<typename K_TYPE , typename V_TYPE , typename Compare , typename ALLOC >

void original::JMap< K_TYPE, V_TYPE, Compare, ALLOC >::Iterator::prev ( ) const

overridevirtual

Not supported (throws unSupportedMethodError)

Implements original::iterator< TYPE >.

The documentation for this class was generated from the following file:

src/core/maps.h

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Iterator() [1/2]

◆ Iterator() [2/2]

Member Function Documentation

◆ atNext()

◆ atPrev()

◆ className()

◆ clone()

◆ get() [1/2]

◆ get() [2/2]

◆ getPrev()

◆ hasNext()

◆ hasPrev()

◆ isValid()

◆ next()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator=()

◆ prev()