Struct FormUrlencodedCodec 

pub struct FormUrlencodedCodec;

Encodes and decodes application/x-www-form-urlencoded text fragments.

Its low-level Codec<Value = u8, Unit = u8> implementation converts one byte at a time, including the form-specific space and + mapping. UTF-8 validation remains part of the owned decode helper.

Implementations

impl FormUrlencodedCodec

pub fn new() -> Self

Creates a form-url-encoded codec.

Returns

Form URL encoded codec.

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

Encodes text, using + for spaces.

Parameters

• text: Text to encode.

Returns

Form-url-encoded text.

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

Decodes text, treating + as space.

Parameters

• text: Text to decode.

Returns

Decoded UTF-8 text.

Errors

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

Trait Implementations

impl Clone for FormUrlencodedCodec

fn clone(&self) -> FormUrlencodedCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Codec for FormUrlencodedCodec

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 form URL 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 FormUrlencodedCodec

impl Debug for FormUrlencodedCodec

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

Formats the value using the given formatter.

impl Default for FormUrlencodedCodec

fn default() -> FormUrlencodedCodec

Returns the “default value” for a type.

impl Eq for FormUrlencodedCodec

impl PartialEq for FormUrlencodedCodec

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

impl ValueDecoder<str> for FormUrlencodedCodec

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

Decodes form-url-encoded text.

type Error = MiscCodecError

Decoding error type.

type Output = String

Decoded output type.

impl ValueEncoder<str> for FormUrlencodedCodec

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

Encodes text, using + for spaces.

type Error = MiscCodecError

Encoding error type.

type Output = String

Encoded output type.