Struct ValueBuf 

pub struct ValueBuf<'sval> { /* private fields */ }

Buffer arbitrary values into a tree-like structure.

This type requires the alloc or std features, otherwise most methods will fail.

Implementations

impl<'sval> ValueBuf<'sval>

pub fn new() -> Self

Create a new empty value buffer.

pub fn collect(v: &'sval (impl Value + ?Sized)) -> Result<Self, Error>

Buffer a value.

This method will fail if the alloc feature is not enabled.

pub fn is_complete(&self) -> bool

Whether or not the contents of the value buffer are complete.

pub fn clear(&mut self)

Clear this buffer so it can be re-used for future values.

pub fn to_value(&self) -> Value<'sval>

Get an independent immutable value from this buffer.

pub fn into_value(self) -> Value<'sval>

Convert this buffer into an immutable value.

pub fn into_owned(self) -> Result<ValueBuf<'static>, Error>

Fully buffer any borrowed data, returning a buffer that doesn’t borrow anything.

This method will fail if the alloc feature is not enabled.

pub fn into_err(self) -> Option<Error>

Take an error produced while attempting to buffer a value.

This method may return None even if streaming failed if a value failed without ever calling into the buffer.

impl ValueBuf<'static>

pub fn collect_owned(v: impl Value) -> Result<Self, Error>

Fully buffer a value, including any internal borrowed data.

This method will fail if the alloc feature is not enabled.

Trait Implementations

impl<'sval> Debug for ValueBuf<'sval>

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

Formats the value using the given formatter.

impl<'sval> Default for ValueBuf<'sval>

fn default() -> Self

Returns the “default value” for a type.

impl<'sval> Stream<'sval> for ValueBuf<'sval>

fn null(&mut self) -> Result

Stream null, the absence of any other meaningful value.

fn bool(&mut self, value: bool) -> Result

Stream a boolean.

fn text_begin(&mut self, _: Option<usize>) -> Result

Start a UTF8 text string.

fn text_fragment(&mut self, fragment: &'sval str) -> Result

Stream a fragment of UTF8 text.

fn text_fragment_computed(&mut self, fragment: &str) -> Result

Stream a fragment of UTF8 text, borrowed for some arbitrarily short lifetime.

fn text_end(&mut self) -> Result

Complete a UTF8 text string.

fn binary_begin(&mut self, _: Option<usize>) -> Result

Start a bitstring.

fn binary_fragment(&mut self, fragment: &'sval [u8]) -> Result

Stream a fragment of a bitstring.

fn binary_fragment_computed(&mut self, fragment: &[u8]) -> Result

Stream a fragment of a bitstring, borrowed for some arbitrarily short lifetime.

fn binary_end(&mut self) -> Result

Complete a bitstring.

fn u8(&mut self, value: u8) -> Result

Stream an unsigned 8bit integer.

fn u16(&mut self, value: u16) -> Result

Stream an unsigned 16bit integer.

fn u32(&mut self, value: u32) -> Result

Stream an unsigned 32bit integer.

fn u64(&mut self, value: u64) -> Result

Stream an unsigned 64bit integer.

fn u128(&mut self, value: u128) -> Result

Stream an unsigned 128bit integer.

fn i8(&mut self, value: i8) -> Result

Stream a signed 8bit integer.

fn i16(&mut self, value: i16) -> Result

Stream a signed 16bit integer.

fn i32(&mut self, value: i32) -> Result

Stream a signed 32bit integer.

fn i64(&mut self, value: i64) -> Result

Stream a signed 64bit integer.

fn i128(&mut self, value: i128) -> Result

Stream a signed 128bit integer.

fn f32(&mut self, value: f32) -> Result

Stream a 32bit binary floating point number.

fn f64(&mut self, value: f64) -> Result

Stream a 64bit binary floating point number.

fn map_begin(&mut self, num_entries_hint: Option<usize>) -> Result

Start a heterogeneous mapping of arbitrary keys to values.

fn map_key_begin(&mut self) -> Result

Start a key in a key-value mapping.

fn map_key_end(&mut self) -> Result

Complete a key in a key-value mapping.

fn map_value_begin(&mut self) -> Result

Start a value in a key-value mapping.

fn map_value_end(&mut self) -> Result

Complete a value in a key-value mapping.

fn map_end(&mut self) -> Result

Complete a heterogeneous mapping of arbitrary keys to values.

fn seq_begin(&mut self, num_entries_hint: Option<usize>) -> Result

Start a heterogeneous sequence of values.

fn seq_value_begin(&mut self) -> Result

Start an individual value in a sequence.

fn seq_value_end(&mut self) -> Result

Complete an individual value in a sequence.

fn seq_end(&mut self) -> Result

Complete a heterogeneous sequence of values.

fn enum_begin( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, ) -> Result

Start a variant in an enumerated type.

fn enum_end( &mut self, _: Option<&Tag>, _: Option<&Label<'_>>, _: Option<&Index>, ) -> Result

Complete a variant in an enumerated type.

fn tagged_begin( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, ) -> Result

Start a tagged value.

fn tagged_end( &mut self, _: Option<&Tag>, _: Option<&Label<'_>>, _: Option<&Index>, ) -> Result

Complete a tagged value.

fn tag( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, ) -> Result

Stream a standalone tag.

fn tag_hint(&mut self, tag: &Tag) -> Result

Use a tag as a hint without streaming it as a value.

fn record_begin( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, num_entries: Option<usize>, ) -> Result

Start a record.

fn record_value_begin(&mut self, tag: Option<&Tag>, label: &Label<'_>) -> Result

Start a field in a record.

fn record_value_end(&mut self, _: Option<&Tag>, _: &Label<'_>) -> Result

Complete a field in a record.

fn record_end( &mut self, _: Option<&Tag>, _: Option<&Label<'_>>, _: Option<&Index>, ) -> Result

Complete a record.

fn tuple_begin( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, num_entries: Option<usize>, ) -> Result

Start a tuple.

fn tuple_value_begin(&mut self, tag: Option<&Tag>, index: &Index) -> Result

Start a field in a tuple.

fn tuple_value_end(&mut self, _: Option<&Tag>, _: &Index) -> Result

Complete a field in a tuple.

fn tuple_end( &mut self, _: Option<&Tag>, _: Option<&Label<'_>>, _: Option<&Index>, ) -> Result

Complete a tuple.

fn record_tuple_begin( &mut self, tag: Option<&Tag>, label: Option<&Label<'_>>, index: Option<&Index>, num_entries: Option<usize>, ) -> Result

Begin a type that may be treated as either a record or a tuple.

fn record_tuple_value_begin( &mut self, tag: Option<&Tag>, label: &Label<'_>, index: &Index, ) -> Result

Begin a field in a type that may be treated as either a record or a tuple.

fn record_tuple_value_end( &mut self, _: Option<&Tag>, _: &Label<'_>, _: &Index, ) -> Result

Complete a field in a type that may be treated as either a record or a tuple.

fn record_tuple_end( &mut self, _: Option<&Tag>, _: Option<&Label<'_>>, _: Option<&Index>, ) -> Result

Complete a type that may be treated as either a record or a tuple.

fn value<V>(&mut self, v: &'sval V) -> Result<(), Error>

where V: Value + ?Sized,

Recurse into a nested value.

fn value_computed<V>(&mut self, v: &V) -> Result<(), Error>

where V: Value + ?Sized,

Recurse into a nested value, borrowed for some arbitrarily short lifetime.

impl<'a> Value for ValueBuf<'a>

fn stream<'sval, S: Stream<'sval> + ?Sized>( &'sval self, stream: &mut S, ) -> Result

Stream this value through a Stream.

fn tag(&self) -> Option<Tag>

Get the tag of this value, if there is one.

fn to_bool(&self) -> Option<bool>

Try convert this value into a boolean.

fn to_f32(&self) -> Option<f32>

Try convert this value into a 32bit binary floating point number.

fn to_f64(&self) -> Option<f64>

Try convert this value into a 64bit binary floating point number.

fn to_i8(&self) -> Option<i8>

Try convert this value into a signed 8bit integer.

fn to_i16(&self) -> Option<i16>

Try convert this value into a signed 16bit integer.

fn to_i32(&self) -> Option<i32>

Try convert this value into a signed 32bit integer.

fn to_i64(&self) -> Option<i64>

Try convert this value into a signed 64bit integer.

fn to_i128(&self) -> Option<i128>

Try convert this value into a signed 128bit integer.

fn to_u8(&self) -> Option<u8>

Try convert this value into an unsigned 8bit integer.

fn to_u16(&self) -> Option<u16>

Try convert this value into an unsigned 16bit integer.

fn to_u32(&self) -> Option<u32>

Try convert this value into an unsigned 32bit integer.

fn to_u64(&self) -> Option<u64>

Try convert this value into an unsigned 64bit integer.

fn to_u128(&self) -> Option<u128>

Try convert this value into an unsigned 128bit integer.

fn to_text(&self) -> Option<&str>

Try convert this value into a text string.

fn to_binary(&self) -> Option<&[u8]>

Try convert this value into a bitstring.

impl<'sval> ValueRef<'sval> for ValueBuf<'sval>

fn stream_ref<S: Stream<'sval> + ?Sized>(&self, stream: &mut S) -> Result

Stream this value through a Stream.