Struct pyo3::types::iterator::PyIterator

#[repr(transparent)]
pub struct PyIterator(PyAny);

A Python iterator object.

Examples

use pyo3::prelude::*;

Python::with_gil(|py| -> PyResult<()> {
    let list = py.eval_bound("iter([1, 2, 3, 4])", None, None)?;
    let numbers: PyResult<Vec<usize>> = list
        .iter()?
        .map(|i| i.and_then(|i|i.extract::<usize>()))
        .collect();
    let sum: usize = numbers?.iter().sum();
    assert_eq!(sum, 10);
    Ok(())
})

Tuple Fields

0: PyAny

Implementations

impl PyIterator

pub fn from_bound_object<'py>( obj: &Bound<'py, PyAny> ) -> PyResult<Bound<'py, PyIterator>>

Builds an iterator for an iterable Python object; the equivalent of calling iter(obj) in Python.

Usually it is more convenient to write obj.iter(), which is a more concise way of calling this function.

Methods from Deref<Target = PyAny>

#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _

Trait Implementations

impl AsPyPointer for PyIterator

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl AsRef<PyAny> for PyIterator

fn as_ref(&self) -> &PyAny

Converts this type into a shared reference of the (usually inferred) input type.

impl Deref for PyIterator

type Target = PyAny

The resulting type after dereferencing.

fn deref(&self) -> &PyAny

Dereferences the value.

impl PyTypeCheck for PyIterator

const NAME: &'static str = "Iterator"

Available on non-crate feature gil-refs only.

Name of self. This is used in error messages, for example.

fn type_check(object: &Bound<'_, PyAny>) -> bool

Available on non-crate feature gil-refs only.

Checks if object is an instance of Self, which may include a subtype.

impl DerefToPyAny for PyIterator