Struct Array 

pub struct Array { /* private fields */ }

Content of an array, CBOR major type 4.

An array holds an ordered sequence of data items and remembers whether it was encoded with a definite length or with the indefinite length form terminated by a break. The items themselves are reached through items and its mutable and owning counterparts.

Example

use cbor_next::{Array, DataItem};

let mut content = Array::from_items([1, 2]);
content.extend([3]);
assert_eq!(content.items().len(), 3);
assert_eq!(content.items()[2], DataItem::from(3));
assert!(!content.is_indefinite());

Implementations

impl Array

pub fn new() -> Self

Create an empty definite length array.

pub fn from_items<I, T>(items: I) -> Self

where I: IntoIterator<Item = T>, T: Into<DataItem>,

Create a definite length array from a sequence of items.

pub fn with_indefinite(self, indefinite: bool) -> Self

Return the same content with the definite or indefinite encoding selected.

Example

use cbor_next::Array;

let content = Array::from_items([1, 2]).with_indefinite(true);
assert!(content.is_indefinite());

pub fn set_indefinite(&mut self, indefinite: bool)

Select the definite or indefinite encoding in place.

pub fn is_indefinite(&self) -> bool

Whether the array uses the indefinite length encoding.

pub fn items(&self) -> &[DataItem]

The items of the array.

pub fn items_mut(&mut self) -> &mut Vec<DataItem>

The items of the array, mutably.

pub fn into_items(self) -> Vec<DataItem>

Take ownership of the items of the array.

Trait Implementations

impl Clone for Array

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Array

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

Formats the value using the given formatter.

impl Default for Array

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Array

impl<T> Extend<T> for Array

where T: Into<DataItem>,

fn extend<I: IntoIterator<Item = T>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl From<Array> for DataItem

fn from(value: Array) -> Self

Converts to this type from the input type.

impl<T> From<Vec<T>> for Array

where T: Into<DataItem>,

fn from(value: Vec<T>) -> Self

Converts to this type from the input type.

impl<T, const N: usize> From<[T; N]> for Array

where T: Into<DataItem>,

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

Converts to this type from the input type.

impl<T> FromIterator<T> for Array

where T: Into<DataItem>,

fn from_iter<I: IntoIterator<Item = T>>(iter: I) -> Self

Creates a value from an iterator.

impl Hash for Array

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Array

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Array