Struct query_string_builder::QueryString

source ·

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

Expand description

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§

source §

impl<'a> QueryString<'a>

source

pub fn new() -> Self

Creates a new, empty query string builder.

source

pub fn with_value(self, key: &'a str, value: &'a str) -> 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"
);

source

pub fn with_opt_value(self, key: &'a str, value: Option<&'a str>) -> 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)
            .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"
);

source

pub fn push(&mut self, key: &'a str, value: &'a str) -> &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"
);

source

pub fn push_opt(&mut self, key: &'a str, value: Option<&'a str>) -> &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);
qs.push_opt("q", Some("🍎 apple"));

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

source

pub fn len(&self) -> usize

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

source

pub fn is_empty(&self) -> bool

Determines if the builder is currently empty.

source

pub fn append(&mut self, other: QueryString<'a>)

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"
);

source

pub fn append_into(self, other: QueryString<'a>) -> 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"
);