Struct pyo3::types::PyList

#[repr(transparent)]pub struct PyList(_, _);

Represents a Python list.

Implementations

impl PyList

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

Constructs a new list with the given elements.

pub fn empty(py: Python) -> &PyList

Constructs a new empty list.

pub fn len(&self) -> usize

Returns the length of the list.

pub fn is_empty(&self) -> bool

Checks if the list is empty.

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

Gets the item at the specified index.

Panics if the index is out of range.

pub fn get_parked_item(&self, index: isize) -> PyObject

Gets the item at the specified index.

Panics if the index is out of range.

pub fn set_item<I>(&self, index: isize, item: I) -> PyResult<()> where
    I: ToPyObject, 

Sets the item at the specified index.

Panics if the index is out of range.

pub fn append<I>(&self, item: I) -> PyResult<()> where
    I: ToBorrowedObject, 

Appends an item to the list.

pub fn insert<I>(&self, index: isize, item: I) -> PyResult<()> where
    I: ToBorrowedObject, 

Inserts an item at the specified index.

Panics if the index is out of range.

pub fn iter(&self) -> PyListIterator

Returns an iterator over this list's items.

pub fn sort(&self) -> PyResult<()>

Sorts the list in-place. Equivalent to the Python expression l.sort().

pub fn reverse(&self) -> PyResult<()>

Reverses the list in-place. Equivalent to the Python expression l.reverse().

Trait Implementations

impl AsPyPointer for PyList

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl AsRef<PyAny> for PyList

fn as_ref(&self) -> &PyAny

Performs the conversion.

impl Debug for PyList

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

Formats the value using the given formatter.

impl Display for PyList

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

Formats the value using the given formatter.

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

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

Performs the conversion.

impl<'py> FromPyObject<'py> for &'py PyList

fn extract(obj: &'py PyAny) -> PyResult<Self>

Extracts Self from the source PyObject.

impl<'a> IntoIterator for &'a PyList

type Item = &'a PyAny

The type of the elements being iterated over.

type IntoIter = PyListIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq<PyList> for PyList

fn eq(&self, o: &PyList) -> 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 PyLayout<PyList> for PyObject

const IS_NATIVE_TYPE: bool

fn get_super(&mut self) -> Option<&mut T::BaseLayout>

unsafe fn py_init(&mut self, _value: T)

unsafe fn py_drop(&mut self, _py: Python)

impl PyNativeType for PyList

fn py(&self) -> Python

impl PyTypeInfo for PyList

type Type = ()

Type of objects to store in PyObject struct

type BaseType = PyAny

Base class

type Layout = PyObject

Layout

type BaseLayout = PyObject

Layout of Basetype.

type Initializer = PyNativeTypeInitializer<Self>

Initializer for layout

type AsRefTarget = Self

Utility type to make AsPyRef work

const NAME: &'static str

Class name

const MODULE: Option<&'static str>

Module name, if any

fn type_object() -> &'static PyTypeObject

PyTypeObject instance for this type.

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 ToPyObject for PyList

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

Converts self into a Python object.