Struct PercentDecodedWhatwgBytes 

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

A percent-decoded string based on percent-decode algorithm of the WHATWG URL standard.

Note that this type does not guarantee that the string is valid percent-encoded string. The raw string may have stray percent character or the following digits may be invalid as hexadecimal digits.

Note that comparisons and hashing via std traits (such as Eq and Hash) will use the raw value, not the content after decoding.

Implementations

impl<'a> PercentDecodedWhatwgBytes<'a>

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

Returns the not-yet-decoded input bytes.

Examples

use iri_string::percent_encode::decode::decode_whatwg_bytes;

let decoded = decode_whatwg_bytes(b"hello%20world");

assert_eq!(decoded.not_yet_decoded(), &b"hello%20world"[..]);

pub fn to_bytes(&self) -> Option<&'a [u8]>

Returns the decoded bytes as a slice if no memory allocation is needed.

Examples

use iri_string::percent_encode::decode::decode_whatwg_bytes;

let no_alloc = decode_whatwg_bytes(b"99% unsafe");
assert_eq!(no_alloc.to_bytes(), Some(&b"99% unsafe"[..]));

let alloc_needed = decode_whatwg_bytes(b"hello%20world");
assert_eq!(alloc_needed.to_bytes(), None);

pub fn into_bytes(&self) -> Cow<'a, [u8]>

Available on crate feature alloc only.

Decodes the bytes, based on percent-decode algorithm of the WHATWG URL standard.

Examples

use iri_string::percent_encode::decode::decode_whatwg_bytes;

let decoded = decode_whatwg_bytes(b"hello%20world");
assert_eq!(decoded.into_bytes(), &b"hello world"[..]);

pub fn into_string(&self) -> Result<String, FromUtf8Error>

Available on crate feature alloc only.

Decodes the bytes into a string, based on percent-decode algorithm of the WHATWG URL standard.

Examples

use iri_string::percent_encode::decode::decode_whatwg_bytes;

let decoded = decode_whatwg_bytes(b"hello%20world");
assert_eq!(
    decoded.into_string(),
    Ok("hello world".to_owned())
);

pub fn bytes_fragments(&self) -> PercentDecodedBytesFragments<'a>

Returns an iterator of decoded fragments.

Examples

use iri_string::percent_encode::decode::{
    decode_whatwg_bytes, DecodedFragment,
};

let mut i = decode_whatwg_bytes(b"100% hello%20world")
    .bytes_fragments();

assert_eq!(i.next(), Some(DecodedFragment::Direct(b"100")));
assert_eq!(i.next(), Some(DecodedFragment::StrayPercent));
assert_eq!(i.next(), Some(DecodedFragment::Direct(b" hello")));
assert_eq!(i.next(), Some(DecodedFragment::DecodedByte(b' ')));
assert_eq!(i.next(), Some(DecodedFragment::Direct(b"world")));
assert_eq!(i.next(), None);

Trait Implementations

impl<'a> Clone for PercentDecodedWhatwgBytes<'a>

fn clone(&self) -> PercentDecodedWhatwgBytes<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PercentDecodedWhatwgBytes<'_>

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

Formats the value using the given formatter.

impl<'a> Hash for PercentDecodedWhatwgBytes<'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> Ord for PercentDecodedWhatwgBytes<'a>

fn cmp(&self, other: &PercentDecodedWhatwgBytes<'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a> PartialEq for PercentDecodedWhatwgBytes<'a>

fn eq(&self, other: &PercentDecodedWhatwgBytes<'a>) -> 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<'a> PartialOrd for PercentDecodedWhatwgBytes<'a>

fn partial_cmp(&self, other: &PercentDecodedWhatwgBytes<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> Copy for PercentDecodedWhatwgBytes<'a>

impl<'a> Eq for PercentDecodedWhatwgBytes<'a>

impl<'a> StructuralPartialEq for PercentDecodedWhatwgBytes<'a>