Struct cbor_data::ArrayBuilder

pub struct ArrayBuilder<'a, T>(_, _);

Builder for an array value.

Calling the finish() method will return either the fully constructed CBOR value (if this was the top-level array) or the builder of the array or dict into which this array was placed.

If you want to recursively create a CBOR structure without statically known recursion limit then you’ll want to take a look at the WriteToArray::write_array_rec() method (the compiler would otherwise kindly inform you of a type expansion hitting the recursion limit while instantiating your recursive function).

Implementations

impl<'a, T: 'static> ArrayBuilder<'a, T>

pub fn finish(self) -> T

Finish building this array and return to the outer context. In case of a top-level array this returns the complete Cbor value.

pub fn write_array(self, tag: Option<u64>) -> ArrayBuilder<'a, Self>

Write a nested array that is then filled by the returned builder. You can resume building this outer array by using the finish() method.

pub fn write_dict(self, tag: Option<u64>) -> DictBuilder<'a, Self>

Write a nested dict that is then filled by the returned builder. You can resume building this outer array by using the finish() method.

Trait Implementations

impl<'a, T: 'static> WriteToArray for ArrayBuilder<'a, T>

pub fn write_pos(&mut self, value: u64, tag: Option<u64>)

Write a unsigned value of up to 64 bits.

pub fn write_neg(&mut self, value: u64, tag: Option<u64>)

Write a negative value of up to 64 bits — the represented number is -1 - value.

pub fn write_bytes(&mut self, value: &[u8], tag: Option<u64>)

Write the given slice as a definite size byte string.

pub fn write_str(&mut self, value: &str, tag: Option<u64>)

Write the given slice as a definite size string.

pub fn write_bool(&mut self, value: bool, tag: Option<u64>)

pub fn write_null(&mut self, tag: Option<u64>)

pub fn write_undefined(&mut self, tag: Option<u64>)

pub fn write_lit(&mut self, value: Literal, tag: Option<u64>)

Write custom literal value — RFC7049 §2.3 is required reading.

pub fn write_array_rec(
    &mut self,
    tag: Option<u64>,
    f: &mut dyn FnMut(&mut dyn WriteToArray)
)

Write a nested array using the given closure that receives an array builder.

pub fn write_dict_rec(
    &mut self,
    tag: Option<u64>,
    f: &mut dyn FnMut(&mut dyn WriteToDict)
)

Write a nested dict using the given closure that receives an dict builder.