Struct query_string_builder::QueryString

pub struct QueryString { /* private fields */ }

A query string builder for percent encoding key-value pairs.

Example

use query_string_builder::QueryString;

let qs = QueryString::new()
            .with_value("q", "apple")
            .with_value("category", "fruits and vegetables");

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=apple&category=fruits%20and%20vegetables"
);

Implementations

impl QueryString

pub fn new() -> Self

Creates a new, empty query string builder.

pub fn with_value<K: Into<String>, V: Into<String>>( self, key: K, value: V ) -> Self

Appends a key-value pair to the query string.

Example

use query_string_builder::QueryString;

let qs = QueryString::new()
            .with_value("q", "🍎 apple")
            .with_value("category", "fruits and vegetables");

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=%F0%9F%8D%8E%20apple&category=fruits%20and%20vegetables"
);

pub fn with_opt_value<K: Into<String>, V: Into<String>>( self, key: K, value: Option<V> ) -> Self

Appends a key-value pair to the query string if the value exists.

Example

use query_string_builder::QueryString;

let qs = QueryString::new()
            .with_opt_value("q", Some("🍎 apple"))
            .with_opt_value("f", None::<String>)
            .with_opt_value("category", Some("fruits and vegetables"));

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=%F0%9F%8D%8E%20apple&category=fruits%20and%20vegetables"
);

pub fn push<K: Into<String>, V: Into<String>>( &mut self, key: K, value: V ) -> &Self

Appends a key-value pair to the query string.

Example

use query_string_builder::QueryString;

let mut qs = QueryString::new();
qs.push("q", "apple");
qs.push("category", "fruits and vegetables");

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=apple&category=fruits%20and%20vegetables"
);

pub fn push_opt<K: Into<String>, V: Into<String>>( &mut self, key: K, value: Option<V> ) -> &Self

Appends a key-value pair to the query string if the value exists.

Example

use query_string_builder::QueryString;

let mut qs = QueryString::new();
qs.push_opt("q", None::<String>);
qs.push_opt("q", Some("🍎 apple"));

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=%F0%9F%8D%8E%20apple"
);

pub fn len(&self) -> usize

Determines the number of key-value pairs currently in the builder.

pub fn is_empty(&self) -> bool

Determines if the builder is currently empty.

pub fn append(&mut self, other: QueryString)

Appends another query string builder’s values.

Example

use query_string_builder::QueryString;

let mut qs = QueryString::new().with_value("q", "apple");
let more = QueryString::new().with_value("q", "pear");

qs.append(more);

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=apple&q=pear"
);

pub fn append_into(self, other: QueryString) -> Self

Appends another query string builder’s values, consuming both types.

Example

use query_string_builder::QueryString;

let qs = QueryString::new().with_value("q", "apple");
let more = QueryString::new().with_value("q", "pear");

let qs = qs.append_into(more);

assert_eq!(
    format!("https://example.com/{qs}"),
    "https://example.com/?q=apple&q=pear"
);

Trait Implementations

impl Clone for QueryString

fn clone(&self) -> QueryString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for QueryString

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

Formats the value using the given formatter.

impl Default for QueryString

fn default() -> QueryString

Returns the “default value” for a type.

impl Display for QueryString

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

Formats the value using the given formatter.