Struct ParameterList

pub struct ParameterList<K, V, A = Vec<(K, V)>, P = (K, V)> { /* private fields */ }

A Request with dynamic list of key-value parameter pairs.

This is like an array of (K, V) but the parameters are guaranteed to be sorted alphabetically.

Example

let request = oauth::ParameterList::new([
   ("foo", 123),
   ("bar", 23),
   ("foo", 3),
]);

let form = oauth::to_form(&request);
assert_eq!(form, "bar=23&foo=123&foo=3");

Implementations

impl<K, V, A, P> ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]>, P: Borrow<(K, V)>,

pub fn from_sorted(list: A) -> Option<Self>

Creates a new ParameterList from sorted list.

Returns None if list is not sorted.

impl<K, V, A, P> ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]> + AsMut<[P]>, P: Borrow<(K, V)>,

pub fn new(list: A) -> Self

Creates a new ParameterList from list.

This function sorts list.

impl<K, V, A, P> ParameterList<K, V, A, P>

pub fn into_inner(self) -> A

Consumes the ParameterList, returning the wrapped value.

impl<K, V, A, P> ParameterList<K, V, A, P>

where A: AsRef<[P]>, P: Borrow<(K, V)>,

pub fn iter(&self) -> Iter<'_, K, V, P>

Returns an iterator over entries of the ParameterList.

Trait Implementations

impl<K, V, A, P> AsRef<[P]> for ParameterList<K, V, A, P>

where A: AsRef<[P]>,

fn as_ref(&self) -> &[P]

Converts this type into a shared reference of the (usually inferred) input type.

impl<K, V, A, P> Default for ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]> + Default, P: Borrow<(K, V)>,

fn default() -> Self

Returns the “default value” for a type.

impl<K, V, A, P> Extend<P> for ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsMut<[P]> + Extend<P>, P: Borrow<(K, V)>,

fn extend<I>(&mut self, iter: I)

where I: IntoIterator<Item = P>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<K, V, A, P> From<A> for ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]> + AsMut<[P]>, P: Borrow<(K, V)>,

fn from(list: A) -> Self

Converts to this type from the input type.

impl<K, V, A, P> FromIterator<P> for ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]> + AsMut<[P]> + FromIterator<P>, P: Borrow<(K, V)>,

fn from_iter<I>(iter: I) -> Self

where I: IntoIterator<Item = P>,

Creates a value from an iterator.

impl<K, V, A, P> Request for ParameterList<K, V, A, P>

where K: AsRef<str>, V: Display, A: AsRef<[P]>, P: Borrow<(K, V)>,

fn serialize<S>(&self, serializer: S) -> S::Output

where S: Serializer,

Feeds a Serializer implementation with the key-value pairs of the request and returns the serializer’s output.