Struct Array 

pub struct Array<'de> { /* private fields */ }

A growable array of TOML Items.

Arrays support indexing with usize via the [] operator, which returns a MaybeItem — out-of-bounds access returns a None variant instead of panicking. Use get / get_mut for Option-based access, or iterate with a for loop.

Mutation methods (push, with_capacity) require an Arena because array storage is arena-allocated.

Implementations

impl<'de> Array<'de>

pub fn new() -> Self

Creates an empty array.

pub fn with_capacity(cap: u32, arena: &Arena) -> Self

Creates an array with pre-allocated capacity.

pub fn with_single(value: Item<'de>, arena: &Arena) -> Self

Creates an array containing a single value.

pub fn push(&mut self, value: Item<'de>, arena: &Arena)

Appends a value to the end of the array.

pub fn len(&self) -> usize

Returns the number of elements.

pub fn is_empty(&self) -> bool

Returns true if the array contains no elements.

pub fn get(&self, index: usize) -> Option<&Item<'de>>

Returns a reference to the element at the given index.

pub fn get_mut(&mut self, index: usize) -> Option<&mut Item<'de>>

Returns a mutable reference to the element at the given index.

pub fn pop(&mut self) -> Option<Item<'de>>

Removes and returns the last element, or None if empty.

pub fn last_mut(&mut self) -> Option<&mut Item<'de>>

Returns a mutable reference to the last element.

pub fn iter(&self) -> Iter<'_, Item<'de>>

Returns an iterator over references to the elements.

pub fn as_slice(&self) -> &[Item<'de>]

Returns the contents as a slice.

pub fn as_mut_slice(&mut self) -> &mut [Item<'de>]

Returns the contents as a mutable slice.

Trait Implementations

impl Debug for Array<'_>

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

Formats the value using the given formatter.

impl<'de> Default for Array<'de>

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Index<usize> for Array<'de>

type Output = MaybeItem<'de>

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a, 'de> IntoIterator for &'a Array<'de>

type Item = &'a Item<'de>

The type of the elements being iterated over.

type IntoIter = Iter<'a, Item<'de>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, 'de> IntoIterator for &'a mut Array<'de>

type Item = &'a mut Item<'de>

The type of the elements being iterated over.

type IntoIter = IterMut<'a, Item<'de>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'de> IntoIterator for Array<'de>

type Item = Item<'de>

The type of the elements being iterated over.

type IntoIter = IntoIter<'de>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.