Struct List

pub struct List { /* private fields */ }

Represents a list of values, all of the same type.

Implementations

impl List

pub fn new( ty: ListType, values: impl IntoIterator<Item = Value>, ) -> Result<Self>

Creates a new list with the provided values. Every value must match the element in the given list type.

pub fn ty(&self) -> ListType

Gets the type of this value.

pub fn typed<T: ListPrimitive>(&self) -> Result<&[T]>

Casts this list to a strongly-typed slice, if possible. For performance reasons, lists are specialized to store primitive types without any wrappers or indirection. This function allows one to access that representation.

pub fn iter(&self) -> impl '_ + Iterator<Item = Value>

Gets an iterator over the values in the list.

pub fn is_empty(&self) -> bool

Whether this list is empty.

pub fn len(&self) -> usize

Gets the length of the list.

Trait Implementations

impl Clone for List

fn clone(&self) -> List

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for List

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

Formats the value using the given formatter.

impl<T: ListPrimitive> From<&[T]> for List

fn from(value: &[T]) -> Self

Converts to this type from the input type.

impl<T: ListPrimitive> From<Arc<[T]>> for List

fn from(value: Arc<[T]>) -> Self

Converts to this type from the input type.

impl<'a> IntoIterator for &'a List

type IntoIter = ListSpecializationIter<'a>

Which kind of iterator are we turning this into?

type Item = Value

The type of the elements being iterated over.

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for List

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.