cppyabm  1.0.17
An agent-based library to integrate C++ and Python
Public Types | Public Member Functions | Static Public Member Functions | Friends | List of all members
iterator Class Reference

#include <pytypes.h>

Inheritance diagram for iterator:
object handle

Public Types

using iterator_category = std::input_iterator_tag
 
using difference_type = ssize_t
 
using value_type = handle
 
using reference = const handle
 
using pointer = const handle *
 

Public Member Functions

iteratoroperator++ ()
 
iterator operator++ (int)
 
reference operator* () const
 
pointer operator-> () const
 
- Public Member Functions inherited from object
 object ()=default
 
 PYBIND11_DEPRECATED ("Use reinterpret_borrow<object>() or reinterpret_steal<object>()") object(handle h
 
 object (const object &o)
 Copy constructor; always increases the reference count. More...
 
 object (object &&other) noexcept
 Move constructor; steals the object from other and preserves its reference count. More...
 
 ~object ()
 Destructor; automatically calls handle::dec_ref() More...
 
handle release ()
 
objectoperator= (const object &other)
 
objectoperator= (object &&other) noexcept
 
template<typename T >
cast () const &
 
template<typename T >
cast () &&
 
 object (handle h, borrowed_t)
 
 object (handle h, stolen_t)
 
template<typename T >
cast () const &
 
template<typename T >
cast () &&
 
template<>
void cast () const &
 
template<>
void cast () &&
 
- Public Member Functions inherited from handle
 handle ()=default
 The default constructor creates a handle with a nullptr-valued pointer. More...
 
 handle (PyObject *ptr)
 Creates a handle from the given raw Python object pointer. More...
 
PyObject * ptr () const
 Return the underlying PyObject * pointer. More...
 
PyObject *& ptr ()
 
const handleinc_ref () const &
 
const handledec_ref () const &
 
template<typename T >
cast () const
 
 operator bool () const
 Return true when the handle wraps a valid Python object. More...
 
bool operator== (const handle &h) const
 
bool operator!= (const handle &h) const
 
bool check () const
 
template<>
void cast () const
 

Static Public Member Functions

static iterator sentinel ()
 

Friends

bool operator== (const iterator &a, const iterator &b)
 
bool operator!= (const iterator &a, const iterator &b)
 

Additional Inherited Members

- Public Attributes inherited from object
bool is_borrowed: handle(h) { if (is_borrowed) inc_ref()
 
- Protected Attributes inherited from handle
PyObject * m_ptr = nullptr
 

Detailed Description

\rst Wraps a Python iterator so that it can also be used as a C++ input iterator

Caveat: copying an iterator does not (and cannot) clone the internal state of the Python iterable. This also applies to the post-increment operator. This iterator should only be used to retrieve the current value using operator*(). \endrst

Definition at line 854 of file pytypes.h.

Member Typedef Documentation

◆ difference_type

Definition at line 857 of file pytypes.h.

◆ iterator_category

using iterator::iterator_category = std::input_iterator_tag

Definition at line 856 of file pytypes.h.

◆ pointer

using iterator::pointer = const handle *

Definition at line 860 of file pytypes.h.

◆ reference

using iterator::reference = const handle

Definition at line 859 of file pytypes.h.

◆ value_type

Definition at line 858 of file pytypes.h.

Member Function Documentation

◆ operator*()

reference iterator::operator* ( ) const
inline

Definition at line 875 of file pytypes.h.

◆ operator++() [1/2]

iterator& iterator::operator++ ( )
inline

Definition at line 864 of file pytypes.h.

◆ operator++() [2/2]

iterator iterator::operator++ ( int  )
inline

Definition at line 869 of file pytypes.h.

◆ operator->()

pointer iterator::operator-> ( ) const
inline

Definition at line 883 of file pytypes.h.

◆ sentinel()

static iterator iterator::sentinel ( )
inlinestatic

\rst The value which marks the end of the iteration. it == iterator::sentinel() is equivalent to catching StopIteration in Python.

.. code-block:: cpp

void foo(py::iterator it) {
    while (it != py::iterator::sentinel()) {

use *it ++it; } } \endrst

Definition at line 898 of file pytypes.h.

Friends And Related Function Documentation

◆ operator!=

bool operator!= ( const iterator a,
const iterator b 
)
friend

Definition at line 901 of file pytypes.h.

◆ operator==

bool operator== ( const iterator a,
const iterator b 
)
friend

Definition at line 900 of file pytypes.h.


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