Struct RawMetainfo 

pub struct RawMetainfo<'a> { /* private fields */ }

Borrowed, syntax-level view of a BitTorrent metainfo dictionary.

Implementations

impl<'a> RawMetainfo<'a>

pub fn from_bytes(original: &'a [u8]) -> Result<Self>

Parses a top-level metainfo dictionary while preserving original bytes.

Errors

Returns a syntax/resource error from bencode parsing, or a metainfo error when the root is not a dictionary or info is missing, duplicated, or not a dictionary.

pub fn from_bytes_with_options( original: &'a [u8], options: ParseOptions, ) -> Result<Self>

Parses a top-level metainfo dictionary using caller-provided limits.

Errors

Returns a syntax/resource error from bencode parsing, or a metainfo error when the root is not a dictionary or info is invalid.

pub fn canonicality(&self) -> Canonicality

Reports whether the original source uses canonical bencode.

pub const fn original_bytes(&self) -> &'a [u8]

Returns the complete original metainfo bytes.

pub fn info_bytes(&self) -> &'a [u8]

Returns the exact original encoded info bytes.

pub fn info_span(&self) -> Span

Returns the exact source span of the encoded info dictionary.

pub fn info_value(&self) -> &Value<'a>

Returns the parsed info dictionary value.

pub fn announce(&self) -> Option<&Value<'a>>

Returns the first announce field, when present.

pub fn announce_list(&self) -> Option<&Value<'a>>

Returns the first announce-list field, when present.

pub fn url_list(&self) -> Option<&Value<'a>>

Returns the first url-list field, when present.

pub fn nodes(&self) -> Option<&Value<'a>>

Returns the first nodes field, when present.

pub fn comment(&self) -> Option<&Value<'a>>

Returns the first comment field, when present.

pub fn created_by(&self) -> Option<&Value<'a>>

Returns the first created by field, when present.

pub fn creation_date(&self) -> Option<&Value<'a>>

Returns the first creation date field, when present.

pub fn unknown_fields(&self) -> Vec<(ByteString<'a>, &Value<'a>)>

Returns top-level entries whose keys are not recognized by this view.

pub fn info_hash_sha1(&self) -> [u8; 20]

Computes SHA-1 over the exact original info bytes.

pub fn info_hash_sha256(&self) -> [u8; 32]

Computes SHA-256 over the exact original info bytes.

Trait Implementations

impl<'a> Debug for RawMetainfo<'a>

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

Formats the value using the given formatter.