Struct cbor_data::DictBuilder

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

Builder for an dict value.

Calling the finish() method will return either the fully constructed CBOR value (if this was the top-level dict) or the builder of the array or dict into which this dict 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 WriteToDict::write_dict_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> DictBuilder<'a, T>

pub fn finish(self) -> T

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

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

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

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

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

Trait Implementations

impl<'a, T: 'static> WriteToDict for DictBuilder<'a, T>

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

Write a unsigned value of up to 64 bits.

pub fn write_neg(&mut self, key: &str, 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, key: &str, value: &[u8], tag: Option<u64>)

Write the given slice as a definite size byte string.

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

Write the given slice as a definite size string.

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

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

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

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

pub fn write_array_rec(
    &mut self,
    key: &str,
    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,
    key: &str,
    tag: Option<u64>,
    f: &mut dyn FnMut(&mut dyn WriteToDict)
)

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