Struct Sequence 

pub struct Sequence { /* private fields */ }

An iterable, addressable series of Ion Elements.

A Sequence is not itself an Ion value type, but can represent a series of Ion values appearing in a List, a SExp, or at the top level.

Implementations

impl Sequence

pub fn new<E: Into<Element>, I: IntoIterator<Item = E>>(elements: I) -> Sequence

pub fn builder() -> SequenceBuilder

pub fn clone_builder(&self) -> SequenceBuilder

pub fn elements(&self) -> SequenceIterator<'_>

pub fn get(&self, index: usize) -> Option<&Element>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> SequenceIterator<'_>

pub fn encode_as<E: Encoding, C: Into<WriteConfig<E>>>( &self, config: C, ) -> IonResult<E::Output>

use ion_rs::{Element, Sequence};
use ion_rs::v1_0::Binary;

let ion_data = r#"1 2 3 foo bar baz"#;
let sequence_before: Sequence = Element::read_all(ion_data)?;

// Encode the elements in this sequence as a binary Ion stream.
let ion_bytes: Vec<u8> = sequence_before.encode_as(Binary)?;
// Read the sequence back from the binary stream
let sequence_after = Element::read_all(ion_bytes)?;

// Confirm that the value we read back is identical to the one we serialized
assert_eq!(sequence_before, sequence_after);

pub fn encode_to<E: Encoding, C: Into<WriteConfig<E>>, W: Write>( &self, output: W, config: C, ) -> IonResult<W>

use ion_rs::{Element, Sequence};
use ion_rs::v1_0::Binary;

let ion_data = r#"1 2 3 foo bar baz"#;
let sequence_before: Sequence = Element::read_all(ion_data)?;

// Encode the elements in this sequence to our buffer as a binary Ion stream. The bytes will
// be written to the provided Vec<u8>, and the Vec<u8> will be returned when encoding is complete.
let ion_bytes: Vec<u8> = sequence_before.encode_to(Vec::new(), Binary)?;
// Read the sequence back from the binary stream
let sequence_after = Element::read_all(ion_bytes)?;

// Confirm that the value we read back is identical to the one we serialized
assert_eq!(sequence_before, sequence_after);

Trait Implementations

impl AsRef<Sequence> for Sequence

fn as_ref(&self) -> &Sequence

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<Sequence> for List

fn as_ref(&self) -> &Sequence

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<Sequence> for SExp

fn as_ref(&self) -> &Sequence

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<[Element]> for Sequence

fn as_ref(&self) -> &[Element]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Sequence

fn clone(&self) -> Sequence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sequence

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

Formats the value using the given formatter.

impl From<List> for Sequence

fn from(value: List) -> Self

Converts to this type from the input type.

impl From<SExp> for Sequence

fn from(value: SExp) -> Self

Converts to this type from the input type.

impl From<Sequence> for Vec<Element>

fn from(value: Sequence) -> Self

Converts to this type from the input type.

impl From<Sequence> for List

fn from(sequence: Sequence) -> Self

Converts to this type from the input type.

impl From<Sequence> for SExp

fn from(sequence: Sequence) -> Self

Converts to this type from the input type.

impl From<Vec<Element>> for Sequence

fn from(elements: Vec<Element>) -> Self

Converts to this type from the input type.

impl FromIterator<Element> for Sequence

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

Creates a value from an iterator.

impl<'a> IntoIterator for &'a Sequence

type Item = &'a Element

The type of the elements being iterated over.

type IntoIter = SequenceIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Sequence

type Item = Element

The type of the elements being iterated over.

type IntoIter = OwnedSequenceIterator

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Sequence

fn eq(&self, other: &Sequence) -> 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.

impl StructuralPartialEq for Sequence

impl TryFrom<Element> for Sequence

type Error = ConversionOperationError<Element, Sequence>

The type returned in the event of a conversion error.

fn try_from(element: Element) -> ConversionOperationResult<Element, Sequence>

Performs the conversion.