Struct DisplayString 

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

A Display String: the percent-encoded text between the quotes, validated as UTF-8 during the parse.

Examples

use parse_net::sfv::{self, BareItem};

let BareItem::DisplayString(d) = sfv::parse_item(b"%\"caf%c3%a9\"")?.bare else { unreachable!() };
assert_eq!(d.raw(), b"caf%c3%a9");
assert_eq!(d.decoded_len(), 5);

Implementations

impl<'a> DisplayString<'a>

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

The text as sent, %xx triples included.

Examples

use parse_net::sfv::{self, BareItem};

let BareItem::DisplayString(d) = sfv::parse_item(b"%\"50%25\"")?.bare else { unreachable!() };
assert_eq!(d.raw(), b"50%25");

pub fn decoded_len(&self) -> usize

The length of the decoded UTF-8 text.

Examples

use parse_net::sfv::{self, BareItem};

let BareItem::DisplayString(d) = sfv::parse_item(b"%\"caf%c3%a9\"")?.bare else { unreachable!() };
assert_eq!(d.decoded_len(), 5);

pub fn decode_into<'b>(&self, out: &'b mut [u8]) -> Result<&'b str, ParseError>

Writes the decoded text into out and returns it.

Errors

ErrorKind::BufferTooSmall; nothing is written.

Examples

use parse_net::sfv::{self, BareItem};

let BareItem::DisplayString(d) = sfv::parse_item(b"%\"caf%c3%a9\"")?.bare else { unreachable!() };
let mut buf = [0u8; 8];
assert_eq!(d.decode_into(&mut buf)?, "caf\u{e9}");

Trait Implementations

impl<'a> Clone for DisplayString<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for DisplayString<'a>

impl<'a> Debug for DisplayString<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for DisplayString<'a>

impl<'a> Hash for DisplayString<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for DisplayString<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for DisplayString<'a>