Enum Bencode 

pub enum Bencode {
    Int(i64),
    Bytes(Vec<u8>),
    List(Vec<Bencode>),
    Dict(BTreeMap<Vec<u8>, Bencode>),
}

A bencoded value — the four shapes the grammar admits.

Bytes is the only string type: bencode has no text/binary distinction on the wire, so the AST keeps raw bytes and offers Bencode::as_str for the UTF-8 view when a field is known textual. Dict is a BTreeMap so iteration — and therefore Bencode::to_bytes — is always in the sorted-key canonical order the protocol requires.

Variants

Int(i64)

i<decimal>e — a 64-bit signed integer.

Bytes(Vec<u8>)

<len>:<bytes> — a length-prefixed byte string.

List(Vec<Bencode>)

l<elements>e — an ordered list.

Dict(BTreeMap<Vec<u8>, Bencode>)

d<key><value>…e — keys are byte strings, sorted + unique.

Implementations

impl Bencode

pub fn to_bytes(&self) -> Vec<u8>

Encode to canonical bencode bytes through a typed builder — never a format!() of the wire syntax (the ★★ TYPED EMISSION rule). Dict keys emit in sorted order (BTreeMap iteration), the canonicalization BitTorrent info-hashing relies on.

pub fn as_int(&self) -> Option<i64>

The integer, if this is an Bencode::Int.

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

The raw bytes, if this is a Bencode::Bytes.

pub fn as_str(&self) -> Option<&str>

The UTF-8 string view of a byte string, if valid UTF-8.

pub fn as_list(&self) -> Option<&[Bencode]>

The elements, if this is a Bencode::List.

pub fn as_dict(&self) -> Option<&BTreeMap<Vec<u8>, Bencode>>

The map, if this is a Bencode::Dict.

pub fn get(&self, key: &[u8]) -> Option<&Bencode>

Look up a key in a dict (by byte key). None if not a dict or the key is absent.

Trait Implementations

impl Clone for Bencode

fn clone(&self) -> Bencode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Bencode

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

Formats the value using the given formatter.

impl Eq for Bencode

impl PartialEq for Bencode

fn eq(&self, other: &Bencode) -> 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 StructuralPartialEq for Bencode