Struct serde_querystring::UrlEncodedQS

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

The simplest parser for querystring It parses the whole querystring, and overwrites each repeated key’s value. it does not support vectors, maps nor tuples, but provides the best performance.

Note

Keys are decoded when calling the parse method, but values are lazily decoded when you call the value method for their keys.

Example

use serde_querystring::UrlEncodedQS;

let slice = b"key=value";

let parser = UrlEncodedQS::parse(slice);

assert_eq!(parser.keys(), vec![&Cow::Borrowed(b"key")]);
assert_eq!(
    parser.value(b"key"),
    Some(Some(Cow::Borrowed("value".as_bytes())))
);

Implementations

impl<'a> UrlEncodedQS<'a>

pub fn deserialize<T: Deserialize<'a>>(self) -> Result<T, Error>

Deserialize the parsed slice into T

impl<'a> UrlEncodedQS<'a>

pub fn parse(slice: &'a [u8]) -> Self

Parse a slice of bytes into a UrlEncodedQS

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

Returns a vector containing all the keys in querystring.

pub fn value(&self, key: &'a [u8]) -> Option<Option<Cow<'a, [u8]>>>

Returns the last value assigned to a key.

It returns None if the key doesn’t exist in the querystring, and returns Some(None) if the last assignment to a key doesn’t have a value, ex "&key&"

Note

Percent decoding the value is done on-the-fly every time this function is called.