Struct qstring::QString

pub struct QString {
    pub params: Vec<Param>,
    // some fields omitted
}

A query string. Holds a list of Params.

Examples

Parameters are indexed by their names.

let qs = qstring::QString::from("?foo=bar%20baz");
let foo = &qs["foo"];
assert_eq!(foo, "bar baz");

Parameters not found are "".

let qs = qstring::QString::from("?foo=bar");
let foo = &qs["panda"];
assert_eq!(foo, "");

The query string can be assembled.

let qs = qstring::QString::new(vec![
   qstring::Param::new("foo", "bar baz"),
   qstring::Param::new("panda", "true"),
]);
assert_eq!(format!("{}", qs), "?&foo=bar%20baz&panda=true");

Can be looped over as Param.

let qs = qstring::QString::from("?foo=bar");
for param in qs {
   assert_eq!(param.name, "foo");
   assert_eq!(param.value, "bar");
   assert_eq!(param, ("foo", "bar"));
}

Fields

params: Vec<Param>

List of parameters in the query string.

Methods

impl QString

fn new(params: Vec<Param>) -> QString

Constructs a QString from a list of Params.

let qs = qstring::QString::new(vec![
   qstring::Param::new("foo", "bar baz"),
   qstring::Param::new("panda", "true"),
]);
assert_eq!(format!("{}", qs), "?&foo=bar%20baz&panda=true");

Trait Implementations

impl Clone for QString

fn clone(&self) -> QString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for QString

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl PartialEq for QString

fn eq(&self, __arg_0: &QString) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &QString) -> bool

This method tests for !=.

impl<'a> From<&'a str> for QString

fn from(origin: &str) -> Self

Constructs a new QString and find the Params therein.

Examples

let qs = qstring::QString::from("?foo=bar");
assert_eq!(qs.params, vec![("foo", "bar")]);

impl IntoIterator for QString

type Item = Param

The type of the elements being iterated over.

type IntoIter = IntoIter<Param>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'b> Index<&'b str> for QString

type Output = String

The returned type after indexing.

fn index(&self, index: &'b str) -> &Self::Output

Performs the indexing (container[index]) operation.

impl Display for QString

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

Formats the value using the given formatter.