Struct AnyIterator

pub struct AnyIterator<'a, Mode>
where
    Mode: ASN1Mode,
{ /* private fields */ }

Iterator for constructed sub-objects contained in an ANY object

In ASN.1, this is supposed to happen only for constructed objects, but this iterator does not test if Self is constructed.

Each call to .next() returns one of the following:

• Some(Ok((input, obj))) if an object was parsed.
  obj is the next sub-object, and has type Any.
  input is the span of the sub-object.
  Unless caller wants information of current offset, input can be ignored
• Some(Err(e)) if an error occurred.
  Note: If e is Incomplete, this means an object has as start but is missing bytes
• None: no more objects

Note: to avoid infinite loops, calling .next() after an error happened will return None (ending iteration).

Implementations

impl<'a, Mode> AnyIterator<'a, Mode>

where Mode: ASN1Mode,

pub fn new(input: Input<'a>) -> Self

impl<'a> AnyIterator<'a, BerMode>

pub fn try_collect<B>(&mut self) -> IResult<Input<'a>, B, BerError<Input<'a>>>

where B: FromIterator<Any<'a>>,

Iterate on sub-objects, returning a collection B of elements with type Any

This is a simplifier (and faster) version of AnyIterator::try_parse_collect when T = Any.

pub fn try_parse_collect<B, T>( &mut self, ) -> IResult<Input<'a>, B, <T as BerParser<'a>>::Error>

where B: FromIterator<T>, T: BerParser<'a>, <T as BerParser<'a>>::Error: From<BerError<Input<'a>>>,

Try to iterate on sub-objects, returning a collection B of elements with type T

Similarly to Iterator::collect, this function requires type annotations.

Since it also has to infer the error type, it is often not possible to use the ? operator directly: .try_parse_collect()?will cause an error because it cannot infer result type. To avoid this, use an itermediate value to store result (or use the turbofish ::<> operator).

Examples

use asn1_rs::{AnyIterator, BerMode, Input};
use hex_literal::hex;

let input = Input::from_slice(&hex!("0203010001 0203010001"));
let mut iter = AnyIterator::<BerMode>::new(input);

let r: Result<(Input, Vec<u32>), _> = iter.try_parse_collect();
let _ = r.expect("parsing failed");

let r = iter.try_parse_collect::<Vec<u32>, _>();
let _ = r.expect("parsing failed");

impl<'a> AnyIterator<'a, DerMode>

pub fn try_collect<B>(&mut self) -> IResult<Input<'a>, B, BerError<Input<'a>>>

where B: FromIterator<Any<'a>>,

Iterate on sub-objects, returning a collection B of elements with type Any

This is a simplifier (and faster) version of AnyIterator::try_parse_collect when T = Any.

pub fn try_parse_collect<B, T>( &mut self, ) -> IResult<Input<'a>, B, <T as DerParser<'a>>::Error>

where B: FromIterator<T>, T: DerParser<'a>, <T as DerParser<'a>>::Error: From<BerError<Input<'a>>>,

Try to iterate on sub-objects, returning a collection B of elements with type T

Similarly to Iterator::collect, this function requires type annotations.

Since it also has to infer the error type, it is often not possible to use the ? operator directly: .try_parse_collect()?will cause an error because it cannot infer result type. To avoid this, use an itermediate value to store result (or use the turbofish ::<> operator).

Examples

use asn1_rs::{AnyIterator, DerMode, Input};
use hex_literal::hex;

let input = Input::from_slice(&hex!("0203010001 0203010001"));
let mut iter = AnyIterator::<DerMode>::new(input);

let r: Result<(Input, Vec<u32>), _> = iter.try_parse_collect();
let _ = r.expect("parsing failed");

let r = iter.try_parse_collect::<Vec<u32>, _>();
let _ = r.expect("parsing failed");

Trait Implementations

impl<'a, Mode> Debug for AnyIterator<'a, Mode>

where Mode: ASN1Mode + Debug,

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

Formats the value using the given formatter.