Struct QueryDict 

pub struct QueryDict { /* private fields */ }

QueryDict.

This type can be used to parse and serialize URL query strings.

The QueryDict uses Vec<_> internally to store the items, so it preserves the item order and allows multiple items with the same key. This also means that complexity of some operations is O(n). However, this should not pose a problem in practice, as the number of query parameters is usually small. It is a trade-off between performance and footprint.

Implementations

impl QueryDict

pub const fn new() -> Self

Create a new instance of QueryDict.

pub fn with_capacity(capacity: usize) -> Self

Create a new instance of QueryDict with a given initial capacity.

pub fn add<T>(&mut self, item: T)

where T: Into<QueryDictItem>,

Add a given item.

This is an O(1) operation.

pub fn set<T>(&mut self, item: T)

where T: Into<QueryDictItem>,

Replace all items having the same name (if any).

This is an O(n) operation.

pub fn remove<N>(&mut self, key: &N)

where N: AsRef<str> + ?Sized,

Remove all items with a given key.

This is an O(n) operation.

pub fn get<'a, N>(&'a self, key: &'a N) -> KeyIter<'a>

where N: AsRef<str> + ?Sized,

Get header fields with a given key.

This is an O(n) operation.

pub fn last<'a, N>(&'a self, key: &'a N) -> Option<&'a QueryDictItem>

where N: AsRef<str> + ?Sized,

Get the last item with a given key.

This is an O(n) operation.

pub fn last_value<'a, N>(&'a self, key: &'a N) -> Option<&'a QueryDictValue>

where N: AsRef<str> + ?Sized,

Get value of the last item with a given key.

This is an O(n) operation.

pub fn all(&self) -> Iter<'_>

Get all items.

pub fn is_empty(&self) -> bool

Check if the collection is empty.

pub fn len(&self) -> usize

Get the number of items in the collection.

Trait Implementations

impl Clone for QueryDict

fn clone(&self) -> QueryDict

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for QueryDict

fn default() -> Self

Returns the “default value” for a type.

impl Display for QueryDict

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

Formats the value using the given formatter.

impl From<Vec<QueryDictItem>> for QueryDict

fn from(items: Vec<QueryDictItem>) -> Self

Converts to this type from the input type.

impl FromStr for QueryDict

type Err = Utf8Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.