Unsafe iterators for bijection. More...

#include <agrum/tools/core/bijection.h>

Public Member Functions
template<typename Alloc , bool Gen>
INLINE	BijectionIterator (const BijectionImplementation< T1, T2, Alloc, Gen > &bijection)
	Constructor. More...

template<typename Alloc >
INLINE	BijectionIterator (const Bijection< T1, T2, Alloc > &bijection)
	Constructor. More...

Constructors/destructors
	BijectionIterator () noexcept
	Default constructor. More...

template<typename Alloc >
	BijectionIterator (const Bijection< T1, T2, Alloc > &bijection)
	Default constructor. More...

	BijectionIterator (const BijectionIterator< T1, T2 > &from)
	Copy constructor. More...

	BijectionIterator (BijectionIterator< T1, T2 > &&from) noexcept
	Move constructor. More...

	~BijectionIterator () noexcept
	Class destructor. More...

Operators
BijectionIterator< T1, T2 > &	operator= (const BijectionIterator< T1, T2 > &toCopy)
	Copy operator. More...

BijectionIterator< T1, T2 > &	operator= (BijectionIterator< T1, T2 > &&toMove) noexcept
	Move operator. More...

BijectionIterator< T1, T2 > &	operator++ () noexcept
	Go to the next association, if it exists. More...

BijectionIterator< T1, T2 > &	operator+= (Size nb) noexcept
	Moves the iterator by nb elements. More...

BijectionIterator< T1, T2 >	operator+ (Size nb) noexcept
	Return a new iterator. More...

bool	operator!= (const BijectionIterator< T1, T2 > &toCompare) const noexcept
	Inequality operator. More...

bool	operator== (const BijectionIterator< T1, T2 > &toCompare) const noexcept
	Equality operator. More...

Accessors/Modifiers
const T1 &	first () const
	Returns the first element of the current association. More...

const T2 &	second () const
	Returns the second element of the current association. More...

Public Types

using	iterator_category = std::forward_iterator_tag
	types for STL compliance More...

using	type1_type = T1
	types for STL compliance More...

using	type1_reference = T1 &
	types for STL compliance More...

using	type1_const_reference = const T1 &
	types for STL compliance More...

using	type1_pointer = T1 *
	types for STL compliance More...

using	type1_const_pointer = const T1 *
	types for STL compliance More...

using	type2_type = T2
	types for STL compliance More...

using	type2_reference = T2 &
	types for STL compliance More...

using	type2_const_reference = const T2 &
	types for STL compliance More...

using	type2_pointer = T2 *
	types for STL compliance More...

using	type2_const_pointer = const T2 *
	types for STL compliance More...

using	difference_type = std::ptrdiff_t
	types for STL compliance More...

Friends
template<typename TT1 , typename TT2 , typename Alloc , bool >
class	BijectionImplementation

Detailed Description

template<typename T1, typename T2>
class gum::BijectionIterator< T1, T2 >

Unsafe iterators for bijection.

Template Parameters

T1	The first type of elements in the gum::Bjection.
T2	The second type of elements in the gum::Bjection.

Definition at line 1593 of file bijection.h.

Member Typedef Documentation

◆ difference_type

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::difference_type = std::ptrdiff_t

types for STL compliance

Definition at line 1611 of file bijection.h.

◆ Getter

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::Getter = BijectionIteratorGet< std::is_scalar< T1 >::value && std::is_scalar< T2 >::value >

private

Dummy classes that will enable discriminate without overhead between scalars and non-scalars functions second in iterators.

Definition at line 1620 of file bijection.h.

◆ HashIter

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::HashIter = typename HashTable12::const_iterator

private

Definition at line 1760 of file bijection.h.

◆ HashTable12

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::HashTable12 = typename std::conditional< std::is_scalar< T1 >::value && std::is_scalar< T2 >::value, HashTable< T1, T2, std::allocator< std::pair< T1, T2 > > >, HashTable< T1, T2*, std::allocator< std::pair< T1, T2* > > > >::type

private

Alias for one of the internal gum::HashTable of the gum::Bijection.

Definition at line 1759 of file bijection.h.

◆ iterator_category

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::iterator_category = std::forward_iterator_tag

types for STL compliance

Definition at line 1600 of file bijection.h.

◆ type1_const_pointer

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type1_const_pointer = const T1*

types for STL compliance

Definition at line 1605 of file bijection.h.

◆ type1_const_reference

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type1_const_reference = const T1&

types for STL compliance

Definition at line 1603 of file bijection.h.

◆ type1_pointer

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type1_pointer = T1*

types for STL compliance

Definition at line 1604 of file bijection.h.

◆ type1_reference

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type1_reference = T1&

types for STL compliance

Definition at line 1602 of file bijection.h.

◆ type1_type

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type1_type = T1

types for STL compliance

Definition at line 1601 of file bijection.h.

◆ type2_const_pointer

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type2_const_pointer = const T2*

types for STL compliance

Definition at line 1610 of file bijection.h.

◆ type2_const_reference

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type2_const_reference = const T2&

types for STL compliance

Definition at line 1608 of file bijection.h.

◆ type2_pointer

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type2_pointer = T2*

types for STL compliance

Definition at line 1609 of file bijection.h.

◆ type2_reference

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type2_reference = T2&

types for STL compliance

Definition at line 1607 of file bijection.h.

◆ type2_type

template<typename T1, typename T2>

using gum::BijectionIterator< T1, T2 >::type2_type = T2

types for STL compliance

Definition at line 1606 of file bijection.h.

Constructor & Destructor Documentation

◆ BijectionIterator() [1/7]

template<typename T1, typename T2>

template<typename Alloc , bool Gen>

gum::BijectionIterator< T1, T2 >::BijectionIterator ( const BijectionImplementation< T1, T2, Alloc, Gen > & bijection )

private

Begin constructor.

By default, the iterator points to the starting point of the bijection.

◆ BijectionIterator() [2/7]

template<typename T1 , typename T2 >

INLINE gum::BijectionIterator< T1, T2 >::BijectionIterator ( )

noexcept

Default constructor.

Definition at line 994 of file bijection_tpl.h.

                                                                  {
     GUM_CONSTRUCTOR(BijectionIterator);
   }

◆ BijectionIterator() [3/7]

template<typename T1, typename T2>

template<typename Alloc >

gum::BijectionIterator< T1, T2 >::BijectionIterator ( const Bijection< T1, T2, Alloc > & bijection )

Default constructor.

Parameters

bijection The gum::Bijection to iterate onto.

◆ BijectionIterator() [4/7]

template<typename T1, typename T2>

INLINE gum::BijectionIterator< T1, T2 >::BijectionIterator ( const BijectionIterator< T1, T2 > & from )

Copy constructor.

Parameters

from	The gum::BijectionIterator to copy.

Definition at line 1018 of file bijection_tpl.h.

                                                                                                  :
       _iter_{toCopy._iter_} {
     GUM_CONS_CPY(BijectionIterator);
   }

◆ BijectionIterator() [5/7]

template<typename T1, typename T2>

INLINE gum::BijectionIterator< T1, T2 >::BijectionIterator ( BijectionIterator< T1, T2 > && from )

noexcept

Move constructor.

move constructor

Parameters

from	The gum::BijectionIterator to move.

Definition at line 1025 of file bijection_tpl.h.

       :
       _iter_{std::move(from._iter_)} {
     GUM_CONS_MOV(BijectionIterator);
   }

◆ ~BijectionIterator()

template<typename T1 , typename T2 >

INLINE gum::BijectionIterator< T1, T2 >::~BijectionIterator ( )

noexcept

Class destructor.

Destructor.

Definition at line 1033 of file bijection_tpl.h.

                                                                   {
     GUM_DESTRUCTOR(BijectionIterator);
   }

◆ BijectionIterator() [6/7]

template<typename T1, typename T2>

template<typename Alloc , bool Gen>

INLINE gum::BijectionIterator< T1, T2 >::BijectionIterator ( const BijectionImplementation< T1, T2, Alloc, Gen > & bijection )

Constructor.

Definition at line 1001 of file bijection_tpl.h.

                                                                      :
       _iter_{bijection._firstToSecond_.cbegin()} {
     GUM_CONSTRUCTOR(BijectionIterator);
   }

◆ BijectionIterator() [7/7]

template<typename T1, typename T2>

template<typename Alloc >

INLINE gum::BijectionIterator< T1, T2 >::BijectionIterator ( const Bijection< T1, T2, Alloc > & bijection )

Constructor.

Definition at line 1011 of file bijection_tpl.h.

                                                                                                :
       _iter_{bijection._firstToSecond_.cbegin()} {
     GUM_CONSTRUCTOR(BijectionIterator);
   }

Member Function Documentation

◆ first()

template<typename T1 , typename T2 >

INLINE const T1 & gum::BijectionIterator< T1, T2 >::first ( ) const

Returns the first element of the current association.

return the first element of the current association

Returns: Returns the first element of the current association.

Exceptions

UndefinedIteratorValue Raised when the iterator does not point to a valid element of the bijection.

Definition at line 1089 of file bijection_tpl.h.

                                                             {
     return _iter_.key();
   }

◆ operator!=()

template<typename T1, typename T2>

INLINE bool gum::BijectionIterator< T1, T2 >::operator!= ( const BijectionIterator< T1, T2 > & toCompare ) const

noexcept

Inequality operator.

Comparison of iterators.

Parameters

toCompare The gum::BijectionIteratorSafe to compare.

Returns: Returns true if they differ.

Definition at line 1075 of file bijection_tpl.h.

                                                                   {
     return _iter_ != toCompare._iter_;
   }

◆ operator+()

template<typename T1 , typename T2 >

INLINE BijectionIterator< T1, T2 > gum::BijectionIterator< T1, T2 >::operator+ ( Size nb )

noexcept

Return a new iterator.

returns a new iterator

If the iterator points to gum::Bijection::end(), the resulting iterator also points to gum::Bijection::end(). If there are nb or fewer elements to parse to reach the end of the gum::Bijection, then the resulting iterator points to gum::Bijection::end().

Definition at line 1069 of file bijection_tpl.h.

                                                                                             {
     return BijectionIterator< T1, T2 >{*this} += nb;
   }

◆ operator++()

template<typename T1 , typename T2 >

INLINE BijectionIterator< T1, T2 > & gum::BijectionIterator< T1, T2 >::operator++ ( )

noexcept

Go to the next association, if it exists.

Go to the next association (if exists)

If the iterator points to gum::Bijection::end(), nothing is done.

Returns: Return sthis gum::BijectionIterator.

Definition at line 1055 of file bijection_tpl.h.

                                                                                        {
     ++_iter_;
     return *this;
   }

◆ operator+=()

template<typename T1 , typename T2 >

INLINE BijectionIterator< T1, T2 > & gum::BijectionIterator< T1, T2 >::operator+= ( Size nb )

noexcept

Moves the iterator by nb elements.

moves the iterator by nb elements

If the iterator points to gum::Bijection::end(), nothing is done. If there are nb or fewer elements to parse to reach the end of the bijection, then this method makes the iterator point to gum::Bijection::end().

Parameters

nb	The number of steps by wich the iterator moves.

Returns: Returns this gum::BijectionIterator.

Definition at line 1062 of file bijection_tpl.h.

                                                                                               {
     _iter_ += nb;
     return *this;
   }

◆ operator=() [1/2]

template<typename T1, typename T2>

INLINE BijectionIterator< T1, T2 > & gum::BijectionIterator< T1, T2 >::operator= ( const BijectionIterator< T1, T2 > & toCopy )

Copy operator.

Parameters

toCopy The gum::BijectionIterator to copy.

Returns: Returns this gum::BijectionIterator.

Definition at line 1040 of file bijection_tpl.h.

                                                                                      {
     _iter_ = toCopy._iter_;
     return *this;
   }

◆ operator=() [2/2]

template<typename T1, typename T2>

INLINE BijectionIterator< T1, T2 > & gum::BijectionIterator< T1, T2 >::operator= ( BijectionIterator< T1, T2 > && toMove )

noexcept

Move operator.

move operator

Parameters

toMove The gum::BijectionIterator to move.

Returns: Returns this gum::BijectionIterator.

Definition at line 1048 of file bijection_tpl.h.

                                                                                          {
     _iter_ = std::move(toCopy._iter_);
     return *this;
   }

◆ operator==()

template<typename T1, typename T2>

INLINE bool gum::BijectionIterator< T1, T2 >::operator== ( const BijectionIterator< T1, T2 > & toCompare ) const

noexcept

Equality operator.

Comparison of iterators.

Parameters

toCompare The gum::BijectionIteratorSafe to compare.

Returns: Returns true if they are equal.

Definition at line 1082 of file bijection_tpl.h.

                                                                   {
     return _iter_ == toCompare._iter_;
   }

◆ second()

template<typename T1 , typename T2 >

INLINE const T2 & gum::BijectionIterator< T1, T2 >::second ( ) const

Returns the second element of the current association.

return the second element of the current association

Returns: Returns the second element of the current association.

Exceptions

UndefinedIteratorValue Raised when the iterator does not point to a valid element of the bijection.

Definition at line 1095 of file bijection_tpl.h.

                                                              {
     return Getter::op_second(_iter_.val());
   }

Friends And Related Function Documentation

◆ BijectionImplementation

template<typename T1, typename T2>

template<typename TT1 , typename TT2 , typename Alloc , bool >

friend class BijectionImplementation

friend

Definition at line 1595 of file bijection.h.

Member Data Documentation

◆ _iter_

template<typename T1, typename T2>

HashIter gum::BijectionIterator< T1, T2 >::_iter_

private

The hashTable iterator that actually does all the job.

Definition at line 1763 of file bijection.h.

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

agrum/tools/core/bijection.h
agrum/tools/core/bijection_tpl.h

Public Member Functions

Public Types

Friends

Detailed Description

template<typename T1, typename T2> class gum::BijectionIterator< T1, T2 >

Member Typedef Documentation

◆ difference_type

◆ Getter

◆ HashIter

◆ HashTable12

◆ iterator_category

◆ type1_const_pointer

◆ type1_const_reference

◆ type1_pointer

◆ type1_reference

◆ type1_type

◆ type2_const_pointer

◆ type2_const_reference

◆ type2_pointer

◆ type2_reference

◆ type2_type

Constructor & Destructor Documentation

◆ BijectionIterator() [1/7]

◆ BijectionIterator() [2/7]

◆ BijectionIterator() [3/7]

◆ BijectionIterator() [4/7]

◆ BijectionIterator() [5/7]

◆ ~BijectionIterator()

◆ BijectionIterator() [6/7]

◆ BijectionIterator() [7/7]

Member Function Documentation

◆ first()

◆ operator!=()

◆ operator+()

◆ operator++()

◆ operator+=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ second()

Friends And Related Function Documentation

◆ BijectionImplementation

Member Data Documentation

◆ _iter_

template<typename T1, typename T2>
class gum::BijectionIterator< T1, T2 >