gum::NodeGraphPartIteratorSafe Class Reference

Safe iterator on the node set of a graph. More...

#include <nodeGraphPart.h>

Inheritance diagram for gum::NodeGraphPartIteratorSafe:

Collaboration diagram for gum::NodeGraphPartIteratorSafe:

Public Member Functions
void	attachSignal__ (__sig__::ISignaler *sender)
void	detachSignal__ (__sig__::ISignaler *sender)
Constructors / Destructors
	NodeGraphPartIteratorSafe (const NodeGraphPart &nodes)
	default constructor More...
	NodeGraphPartIteratorSafe (const NodeGraphPartIteratorSafe &it)
	copy constructor More...
	NodeGraphPartIteratorSafe (NodeGraphPartIteratorSafe &&it)
	move constructor More...
	~NodeGraphPartIteratorSafe ()
	destructor More...
Operators
NodeGraphPartIteratorSafe &	operator= (const NodeGraphPartIteratorSafe &it)
	copy assignment operator More...
NodeGraphPartIteratorSafe &	operator= (NodeGraphPartIteratorSafe &&it)
	move assignment operator More...
Accessors / Modifiers
void	whenNodeDeleted (const void *src, NodeId id)
	called when a node is deleted in the iterated NodeGraphPart More...
Operators
bool	operator== (const NodeGraphPartIterator &it) const noexcept
	checks whether two iterators point toward the same node More...
bool	operator!= (const NodeGraphPartIterator &it) const noexcept
	checks whether two iterators point toward different nodes More...
NodeGraphPartIterator &	operator++ () noexcept
	increment the iterator More...
value_type	operator* () const
	dereferencing operator More...

Public Types
using	iterator_category = std::forward_iterator_tag
	types for STL compliance More...
using	value_type = NodeId
	types for STL compliance More...
using	reference = value_type &
	types for STL compliance More...
using	const_reference = const value_type &
	types for STL compliance More...
using	pointer = value_type *
	types for STL compliance More...
using	const_pointer = const value_type *
	types for STL compliance More...
using	difference_type = std::ptrdiff_t
	types for STL compliance More...

Protected Attributes
const NodeGraphPart *	_nodes
	the nodegraphpart on which points the iterator More...
NodeId	_pos {0}
	the nodeid on which the iterator points currently More...
bool	_valid {false}

Protected Member Functions
void	_setPos (NodeId id) noexcept
	this function is used by NodeGraphPart to update More...
void	_validate () noexcept
	ensure that the nodeId is either end() either a valid NodeId More...

Friends
class	NodeGraphPart

Detailed Description

Safe iterator on the node set of a graph.

Definition at line 137 of file nodeGraphPart.h.

Member Typedef Documentation

const_pointer

using gum::NodeGraphPartIteratorSafe::const_pointer = const value_type*

types for STL compliance

Definition at line 150 of file nodeGraphPart.h.

const_reference

using gum::NodeGraphPartIteratorSafe::const_reference = const value_type&

types for STL compliance

Definition at line 148 of file nodeGraphPart.h.

difference_type

using gum::NodeGraphPartIteratorSafe::difference_type = std::ptrdiff_t

types for STL compliance

Definition at line 151 of file nodeGraphPart.h.

iterator_category

using gum::NodeGraphPartIteratorSafe::iterator_category = std::forward_iterator_tag

types for STL compliance

Definition at line 145 of file nodeGraphPart.h.

pointer

using gum::NodeGraphPartIteratorSafe::pointer = value_type*

types for STL compliance

Definition at line 149 of file nodeGraphPart.h.

reference

using gum::NodeGraphPartIteratorSafe::reference = value_type&

types for STL compliance

Definition at line 147 of file nodeGraphPart.h.

value_type

using gum::NodeGraphPartIteratorSafe::value_type = NodeId

types for STL compliance

Definition at line 146 of file nodeGraphPart.h.

Constructor & Destructor Documentation

NodeGraphPartIteratorSafe() [1/3]

INLINE gum::NodeGraphPartIteratorSafe::NodeGraphPartIteratorSafe

(

const NodeGraphPart &

nodes

)

default constructor

Definition at line 149 of file nodeGraphPart_inl.h.

References GUM_CONNECT, and whenNodeDeleted().

                                 :
      NodeGraphPartIterator(nodes) {
    GUM_CONNECT(*const_cast< NodeGraphPart* >(&nodes),
                onNodeDeleted,
                *this,
                NodeGraphPartIteratorSafe::whenNodeDeleted);
    GUM_CONSTRUCTOR(NodeGraphPartIteratorSafe);
  }

Here is the call graph for this function:

NodeGraphPartIteratorSafe() [2/3]

INLINE gum::NodeGraphPartIteratorSafe::NodeGraphPartIteratorSafe

(

const NodeGraphPartIteratorSafe &

it

)

copy constructor

Definition at line 161 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_nodes, GUM_CONNECT, and whenNodeDeleted().

                                          :
      NodeGraphPartIterator(it) {
    GUM_CONNECT(*const_cast< NodeGraphPart* >(_nodes),
                onNodeDeleted,
                *this,
                NodeGraphPartIteratorSafe::whenNodeDeleted);
    GUM_CONS_CPY(NodeGraphPartIteratorSafe);
  }

Here is the call graph for this function:

NodeGraphPartIteratorSafe() [3/3]

INLINE gum::NodeGraphPartIteratorSafe::NodeGraphPartIteratorSafe

(

NodeGraphPartIteratorSafe &&

it

)

move constructor

Definition at line 173 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_nodes, GUM_CONNECT, and whenNodeDeleted().

                                     :
      NodeGraphPartIterator(std::move(it)) {
    GUM_CONNECT(*const_cast< NodeGraphPart* >(_nodes),
                onNodeDeleted,
                *this,
                NodeGraphPartIteratorSafe::whenNodeDeleted);
    GUM_CONS_MOV(NodeGraphPartIteratorSafe);
  }

Here is the call graph for this function:

~NodeGraphPartIteratorSafe()

INLINE gum::NodeGraphPartIteratorSafe::~NodeGraphPartIteratorSafe

(

)

destructor

Definition at line 184 of file nodeGraphPart_inl.h.

References operator=().

                                                               {
    GUM_DESTRUCTOR(NodeGraphPartIteratorSafe);
  }

Here is the call graph for this function:

Member Function Documentation

_setPos()

INLINE void gum::NodeGraphPartIterator::_setPos ( NodeId  id )

protectednoexceptinherited

this function is used by NodeGraphPart to update

Definition at line 134 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_nodes, gum::NodeGraphPartIterator::_pos, gum::NodeGraphPartIterator::_valid, gum::NodeGraphPart::bound(), and gum::NodeGraphPart::exists().

                                                               {
    _pos = id;

    if (_pos >= _nodes->bound()) {
      _pos = _nodes->bound();
      _valid = false;
    } else {
      _valid = _nodes->exists(_pos);
    }
  }

Here is the call graph for this function:

_validate()

INLINE void gum::NodeGraphPartIterator::_validate ( )

protectednoexceptinherited

ensure that the nodeId is either end() either a valid NodeId

Definition at line 35 of file nodeGraphPart_inl.h.

References gum::NodeGraphPart::__inHoles(), gum::NodeGraphPartIterator::_nodes, gum::NodeGraphPartIterator::_pos, gum::NodeGraphPartIterator::_valid, and gum::NodeGraphPart::bound().

Referenced by gum::NodeGraphPart::begin(), gum::NodeGraphPart::beginSafe(), and gum::NodeGraphPartIterator::operator++().

                                                        {
    _valid = false;

    if (_pos > _nodes->bound()) { _pos = _nodes->bound(); }

    while (_pos < _nodes->bound()) {
      if (!_nodes->__inHoles(_pos)) {
        _valid = true;
        return;
      }

      ++_pos;
    }
  }

Here is the call graph for this function:

Here is the caller graph for this function:

attachSignal__()

INLINE void gum::Listener::attachSignal__ ( __sig__::ISignaler *  sender )

inherited

Definition at line 33 of file listener_inl.h.

References gum::Listener::__senders.

                                                               {
    __senders.push_back(sender);
  }

detachSignal__()

INLINE void gum::Listener::detachSignal__ ( __sig__::ISignaler *  sender )

inherited

Definition at line 37 of file listener_inl.h.

References gum::Listener::__senders.

                                                               {
    auto del = std::remove(__senders.begin(), __senders.end(), sender);

    if (del != __senders.end()) __senders.erase(del, __senders.end());
  }

operator!=()

INLINE bool gum::NodeGraphPartIterator::operator!= ( const NodeGraphPartIterator &  it ) const

noexceptinherited

checks whether two iterators point toward different nodes

Definition at line 112 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::operator==().

              {
    return !(operator==(it));
  }

Here is the call graph for this function:

operator*()

INLINE NodeId gum::NodeGraphPartIterator::operator* ( ) const

inherited

dereferencing operator

Definition at line 125 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_pos, gum::NodeGraphPartIterator::_valid, and GUM_ERROR.

                                                       {
    if (!_valid) {
      GUM_ERROR(UndefinedIteratorValue, "This iterator is not valid !");
    }

    return _pos;
  }

operator++()

INLINE NodeGraphPartIterator & gum::NodeGraphPartIterator::operator++ ( )

noexceptinherited

increment the iterator

Definition at line 118 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_pos, and gum::NodeGraphPartIterator::_validate().

                                                                           {
    ++_pos;
    _validate();
    return *this;
  }

Here is the call graph for this function:

operator=() [1/2]

INLINE NodeGraphPartIteratorSafe & gum::NodeGraphPartIteratorSafe::operator=

(

const NodeGraphPartIteratorSafe &

it

)

copy assignment operator

Definition at line 190 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::operator=().

Referenced by ~NodeGraphPartIteratorSafe().

                                                                                   {
    //  avoid self assignment
    if (&it != this) {
      NodeGraphPartIterator::operator=(it);
      Listener::             operator=(it);
      GUM_OP_CPY(NodeGraphPartIteratorSafe);
    }

    return *this;
  }

Here is the call graph for this function:

Here is the caller graph for this function:

operator=() [2/2]

INLINE NodeGraphPartIteratorSafe & gum::NodeGraphPartIteratorSafe::operator=

(

NodeGraphPartIteratorSafe &&

it

)

move assignment operator

Definition at line 203 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::operator=().

                                                                              {
    //  avoid self assignment
    if (&it != this) {
      NodeGraphPartIterator::operator=(std::move(it));
      Listener::             operator=(std::move(it));
      GUM_OP_MOV(NodeGraphPartIteratorSafe);
    }

    return *this;
  }

Here is the call graph for this function:

operator==()

INLINE bool gum::NodeGraphPartIterator::operator== ( const NodeGraphPartIterator &  it ) const

noexceptinherited

checks whether two iterators point toward the same node

Definition at line 105 of file nodeGraphPart_inl.h.

References gum::NodeGraphPartIterator::_nodes, gum::NodeGraphPartIterator::_pos, and gum::NodeGraphPartIterator::_valid.

Referenced by gum::NodeGraphPartIterator::operator!=(), and gum::NodeGraphPart::operator!=().

              {
    return ((_pos == it._pos) && (_valid == it._valid) && (_nodes == it._nodes));
  }

Here is the caller graph for this function:

whenNodeDeleted()

void gum::NodeGraphPartIteratorSafe::whenNodeDeleted	(	const void *	src,
		NodeId	id
	)

called when a node is deleted in the iterated NodeGraphPart

Parameters

src	the NodeGraphPart
id	id of deleted node

Definition at line 168 of file nodeGraphPart.cpp.

Referenced by NodeGraphPartIteratorSafe().

                                                                            {
    if (id == _pos) {   // we just deleted the _pos in NodeGraphPart
      _valid = false;
    }

    if (_pos >= _nodes->bound()) {   // moreover, it was the last position
      _pos = _nodes->bound();
      _valid = false;
    }
  }

Here is the caller graph for this function:

Friends And Related Function Documentation

NodeGraphPart

friend class NodeGraphPart

friend

Definition at line 140 of file nodeGraphPart.h.

Member Data Documentation

_nodes

const NodeGraphPart* gum::NodeGraphPartIterator::_nodes

protectedinherited

the nodegraphpart on which points the iterator

Definition at line 124 of file nodeGraphPart.h.

Referenced by gum::NodeGraphPartIterator::_setPos(), gum::NodeGraphPartIterator::_validate(), NodeGraphPartIteratorSafe(), gum::NodeGraphPartIterator::operator=(), and gum::NodeGraphPartIterator::operator==().

_pos

NodeId gum::NodeGraphPartIterator::_pos {0}

protectedinherited

the nodeid on which the iterator points currently

Definition at line 127 of file nodeGraphPart.h.

Referenced by gum::NodeGraphPartIterator::_setPos(), gum::NodeGraphPartIterator::_validate(), gum::NodeGraphPartIterator::operator*(), gum::NodeGraphPartIterator::operator++(), gum::NodeGraphPartIterator::operator=(), and gum::NodeGraphPartIterator::operator==().

_valid

bool gum::NodeGraphPartIterator::_valid {false}

protectedinherited

Definition at line 130 of file nodeGraphPart.h.

Referenced by gum::NodeGraphPartIterator::_setPos(), gum::NodeGraphPartIterator::_validate(), gum::NodeGraphPartIterator::operator*(), gum::NodeGraphPartIterator::operator=(), and gum::NodeGraphPartIterator::operator==().

---

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

• agrum/graphs/parts/nodeGraphPart.h
• agrum/graphs/parts/nodeGraphPart.cpp
• agrum/graphs/parts/nodeGraphPart_inl.h