Struct PercentCodec 

pub struct PercentCodec;

Encodes and decodes percent-encoded UTF-8 text.

Its low-level Codec<Value = u8, Unit = u8> implementation converts one byte to either one unreserved ASCII unit or a %XX escape. UTF-8 validation remains part of the owned decode helper.

Implementations

impl PercentCodec

pub fn new() -> Self

Creates a percent codec.

Returns

Percent codec.

pub fn encode(&self, text: &str) -> String

Encodes text using percent encoding.

Parameters

• text: UTF-8 text to encode.

Returns

Percent-encoded text.

pub fn decode(&self, text: &str) -> MiscCodecResult<String>

Decodes percent-encoded UTF-8 text.

Parameters

• text: Percent-encoded text.

Returns

Decoded UTF-8 text.

Errors

Returns MiscCodecError when a percent escape is malformed or decoded bytes are not valid UTF-8.

Trait Implementations

impl Clone for PercentCodec

fn clone(&self) -> PercentCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Codec for PercentCodec

fn min_units_per_value(&self) -> NonZeroUsize

Returns the shortest representation length for one byte.

fn max_units_per_value(&self) -> NonZeroUsize

Returns the longest %XX representation length for one byte.

unsafe fn decode_unchecked( &self, input: &[u8], index: usize, ) -> Result<(u8, NonZeroUsize), Self::DecodeError>

Decodes one raw byte or %XX escape.

unsafe fn encode_unchecked( &self, value: &u8, output: &mut [u8], index: usize, ) -> Result<usize, Self::EncodeError>

Encodes one byte using percent encoding.

type Value = u8

Logical value decoded from or encoded into the buffer.

type Unit = u8

Buffer unit used by the encoded representation.

type DecodeError = MiscCodecError

Error reported when decoding malformed units.

type EncodeError = MiscCodecError

Error reported when encoding an unsupported value.

impl Copy for PercentCodec

impl Debug for PercentCodec

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

Formats the value using the given formatter.

impl Default for PercentCodec

fn default() -> PercentCodec

Returns the “default value” for a type.

impl Eq for PercentCodec

impl PartialEq for PercentCodec

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

impl ValueDecoder<str> for PercentCodec

fn decode(&self, input: &str) -> Result<Self::Output, Self::Error>

Decodes percent-encoded text.

type Error = MiscCodecError

Decoding error type.

type Output = String

Decoded output type.

impl ValueEncoder<str> for PercentCodec

fn encode(&self, input: &str) -> Result<Self::Output, Self::Error>

Encodes text using percent encoding.

type Error = MiscCodecError

Encoding error type.

type Output = String

Encoded output type.