Enum OwnedValue 

pub enum OwnedValue {
    Integer(i64),
    IntegerBytes(Vec<u8>),
    Bytes(Vec<u8>),
    List(Vec<Self>),
    Dictionary(BTreeMap<Vec<u8>, Self>),
}

An owned bencode value that serializes canonically.

Variants

Integer(i64)

Signed bencode integer.

IntegerBytes(Vec<u8>)

Arbitrary-precision canonical signed decimal bytes.

Bytes(Vec<u8>)

Raw byte string.

List(Vec<Self>)

Ordered list of values.

Dictionary(BTreeMap<Vec<u8>, Self>)

Dictionary stored in canonical raw-byte key order.

Implementations

impl OwnedValue

pub const fn integer(value: i64) -> Self

Creates an integer value.

pub fn integer_bytes(value: impl AsRef<[u8]>) -> Result<Self>

Creates an arbitrary-precision canonical integer.

Errors

Returns a canonical error for empty digits, non-digits, a plus sign, leading zeroes, or negative zero.

pub fn bytes(value: impl Into<Vec<u8>>) -> Self

Creates a byte-string value.

pub fn list(values: impl IntoIterator<Item = Self>) -> Self

Creates a list value.

pub fn dictionary( entries: impl IntoIterator<Item = (Vec<u8>, Self)>, ) -> Result<Self>

Creates a dictionary and rejects duplicate raw byte keys.

Errors

Returns a canonical error if the input contains duplicate keys.

pub fn encoded_len(&self) -> usize

Returns the exact canonical encoded length.

pub fn write_to(&self, writer: &mut impl Write) -> Result<()>

Writes canonical bencode to a byte writer.

Errors

Returns an I/O error preserving the writer’s original error as its source.

pub fn to_vec(&self) -> Result<Vec<u8>>

Encodes this value into a pre-sized byte vector.

Errors

Returns an I/O error if writing to the vector unexpectedly fails.

Trait Implementations

impl Clone for OwnedValue

fn clone(&self) -> OwnedValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedValue

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

Formats the value using the given formatter.

impl PartialEq for OwnedValue

fn eq(&self, other: &OwnedValue) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for OwnedValue

impl StructuralPartialEq for OwnedValue