Struct sval_buffer::BinaryBuf

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

Buffer binary fragments into a single contiguous slice.

In no-std environments, this buffer only supports a single borrowed binary fragment. Other methods will fail.

Implementations

impl<'sval> BinaryBuf<'sval>

pub fn new() -> Self

Create a new empty binary buffer.

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

Buffer a binary value into a contiguous slice.

pub fn clear(&mut self)

Clear the binary buffer so it can be re-used.

pub fn push_fragment(&mut self, fragment: &'sval [u8]) -> Result<(), Error>

Push a borrowed binary fragment onto the buffer.

pub fn push_fragment_computed(&mut self, fragment: &[u8]) -> Result<(), Error>

Push a computed binary fragment onto the buffer.

If the std feature of this library is enabled, this method will buffer the fragment. In no-std environments this method will fail.

pub fn as_borrowed_slice(&self) -> Option<&'sval [u8]>

Try get the contents of the buffer as a slice borrowed for the 'sval lifetime.

pub fn as_slice(&self) -> &[u8]

Get the contents of the buffer as a slice.

Trait Implementations

impl<'sval> AsRef<[u8]> for BinaryBuf<'sval>

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

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

impl<'sval> Clone for BinaryBuf<'sval>

fn clone(&self) -> BinaryBuf<'sval>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'sval> Debug for BinaryBuf<'sval>

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

Formats the value using the given formatter.

impl<'sval> Default for BinaryBuf<'sval>

fn default() -> Self

Returns the “default value” for a type.

impl<'sval> From<&'sval [u8]> for BinaryBuf<'sval>

fn from(fragment: &'sval [u8]) -> Self

Converts to this type from the input type.

impl<'sval, const N: usize> From<&'sval [u8; N]> for BinaryBuf<'sval>

fn from(fragment: &'sval [u8; N]) -> Self

Converts to this type from the input type.

impl<'sval> PartialEq for BinaryBuf<'sval>

fn eq(&self, other: &BinaryBuf<'sval>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Value for BinaryBuf<'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 BinaryBuf<'sval>

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

Stream this value through a Stream.

impl<'sval> Eq for BinaryBuf<'sval>

impl<'sval> StructuralEq for BinaryBuf<'sval>

impl<'sval> StructuralPartialEq for BinaryBuf<'sval>