Struct pyo3::types::PyTuple

#[repr(transparent)]
pub struct PyTuple(_);

Represents a Python tuple object.

Methods

impl PyTuple

pub fn new<'p, T, U>(
    py: Python<'p>,
    elements: impl IntoIterator<Item = T, IntoIter = U>
) -> &'p PyTuple where
    T: ToPyObject,
    U: ExactSizeIterator<Item = T>, 

Construct a new tuple with the given elements.

pub fn empty<'p>(py: Python<'p>) -> &'p PyTuple

Retrieves the empty tuple.

pub fn len(&self) -> usize

Gets the length of the tuple.

pub fn is_empty(&self) -> bool

Check if tuple is empty.

pub fn slice(&self, low: isize, high: isize) -> Py<PyTuple>

Take a slice of the tuple pointed to by p from low to high and return it as a new tuple.

pub fn split_from(&self, low: isize) -> Py<PyTuple>

Take a slice of the tuple pointed to by p from low and return it as a new tuple.

pub fn get_item(&self, index: usize) -> &PyAny

Gets the item at the specified index.

Panics if the index is out of range.

pub fn as_slice(&self) -> &[PyObject]

pub fn iter(&self) -> PyTupleIterator

Returns an iterator over the tuple items.

Trait Implementations

impl AsPyPointer for PyTuple

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl ToPyObject for PyTuple

fn to_object(&self, py: Python) -> PyObject

Converts self into a Python object.

impl<'a> FromPy<&'a PyTuple> for Py<PyTuple>

fn from_py(tuple: &'a PyTuple, _py: Python) -> Py<PyTuple>

Performs the conversion.

impl PyNativeType for PyTuple

fn py(&self) -> Python

impl PyTypeInfo for PyTuple

type Type = ()

Type of objects to store in PyObject struct

type BaseType = PyAny

Base class

const NAME: &'static str

Class name

const SIZE: usize

Size of the rust PyObject structure (PyObject + rust structure)

const OFFSET: isize

Type instance offset inside PyObject structure

unsafe fn type_object() -> &'static mut PyTypeObject

PyTypeObject instance for this type, which might still need to be initialized

fn is_instance(ptr: &PyAny) -> bool

Check if *mut ffi::PyObject is instance of this type

const DESCRIPTION: &'static str

Class doc string

const FLAGS: usize

Type flags (ie PY_TYPE_FLAG_GC, PY_TYPE_FLAG_WEAKREF)

fn is_exact_instance(object: &PyAny) -> bool

Check if *mut ffi::PyObject is exact instance of this type

impl PyObjectAlloc for PyTuple

unsafe fn alloc(_py: Python) -> *mut PyObject

unsafe fn dealloc(py: Python, obj: *mut PyObject)

Calls the rust destructor for the object and frees the memory (usually by calling ptr->ob_type->tp_free). This function is used as tp_dealloc implementation.

unsafe fn drop(py: Python, obj: *mut PyObject)

Calls the rust destructor for the object.

impl PyTypeObject for PyTuple

fn init_type() -> NonNull<PyTypeObject>

This function must make sure that the corresponding type object gets initialized exactly once and return it.

fn type_object() -> Py<PyType>

Returns the safe abstraction over the type object from PyTypeObject::init_type

impl<'a> From<&'a PyTuple> for &'a PyAny

fn from(ob: &'a PyTuple) -> Self

Performs the conversion.

impl PartialEq<PyTuple> for PyTuple

fn eq(&self, o: &PyTuple) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl AsRef<PyAny> for PyTuple

fn as_ref(&self) -> &PyAny

Performs the conversion.

impl<'a> IntoIterator for &'a PyTuple

type Item = &'a PyAny

The type of the elements being iterated over.

type IntoIter = PyTupleIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Display for PyTuple

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl Debug for PyTuple

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.