pub struct PyList(/* private fields */);Expand description
Represents a Python list.
Values of this type are accessed via PyO3’s smart pointers, e.g. as
Py<PyList> or Bound<'py, PyList>.
For APIs available on list objects, see the PyListMethods trait which is implemented for
Bound<'py, PyList>.
Implementations§
Source§impl PyList
impl PyList
Sourcepub fn new<'py, T, U>(
py: Python<'py>,
elements: impl IntoIterator<Item = T, IntoIter = U>,
) -> PyResult<Bound<'py, PyList>>where
T: IntoPyObject<'py>,
U: ExactSizeIterator<Item = T>,
pub fn new<'py, T, U>(
py: Python<'py>,
elements: impl IntoIterator<Item = T, IntoIter = U>,
) -> PyResult<Bound<'py, PyList>>where
T: IntoPyObject<'py>,
U: ExactSizeIterator<Item = T>,
Constructs a new list with the given elements.
If you want to create a PyList with elements of different or unknown types, or from an
iterable that doesn’t implement ExactSizeIterator, use PyListMethods::append.
§Examples
use pyo3::prelude::*;
use pyo3::types::PyList;
Python::attach(|py| {
let elements: Vec<i32> = vec![0, 1, 2, 3, 4, 5];
let list = PyList::new(py, elements)?;
assert_eq!(format!("{:?}", list), "[0, 1, 2, 3, 4, 5]");
})§Panics
This function will panic if element’s ExactSizeIterator implementation is incorrect.
All standard library structures implement this trait correctly, if they do, so calling this
function with (for example) Vec<T> or &[T] will always succeed.
Trait Implementations§
Source§impl PyTypeInfo for PyList
impl PyTypeInfo for PyList
Source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Returns the PyTypeObject instance for this type.
Source§fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
fn is_type_of(obj: &Bound<'_, PyAny>) -> bool
Checks if
object is an instance of this type or a subclass of this type.Source§const PYTHON_TYPE: &'static str = "typing.Any"
const PYTHON_TYPE: &'static str = "typing.Any"
Available on crate feature
experimental-inspect only.Provides the full python type paths.
impl DerefToPyAny for PyList
Auto Trait Implementations§
impl !Freeze for PyList
impl !RefUnwindSafe for PyList
impl !Send for PyList
impl !Sync for PyList
impl Unpin for PyList
impl UnwindSafe for PyList
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> PyTypeCheck for Twhere
T: PyTypeInfo,
impl<T> PyTypeCheck for Twhere
T: PyTypeInfo,
Source§const NAME: &'static str = const NAME: &'static str = T::NAME;
const NAME: &'static str = const NAME: &'static str = T::NAME;
👎Deprecated since 0.27.0: Use ::classinfo_object() instead and format the type name at runtime. Note that using built-in cast features is often better than manual PyTypeCheck usage.
Name of self. This is used in error messages, for example.
Source§const PYTHON_TYPE: &'static str = const PYTHON_TYPE: &'static str = <T as PyTypeInfo>::PYTHON_TYPE;
const PYTHON_TYPE: &'static str = const PYTHON_TYPE: &'static str = <T as PyTypeInfo>::PYTHON_TYPE;
Available on crate feature
experimental-inspect only.Provides the full python type of the allowed values.