Struct Query 

pub struct Query { /* private fields */ }

Ordered query parameters for an OCS call.

OCS reads parameters by name, so order does not matter to the server, but insertion order is preserved here to keep a built query stable across runs and comparable in tests.

Implementations

impl Query

pub const fn new() -> Self

Empty query.

pub fn param(self, key: impl Into<String>, value: impl Into<String>) -> Self

Adds a parameter, replacing an existing one with the same name.

Keys and values are percent-encoded when the query is built, so callers pass raw text: a value containing & or = stays one value.

pub fn format(self, format: OcsFormat) -> Self

Selects the response format.

Equivalent to .param("format", format), kept as its own method so the requirement for format=json is impossible to miss at a call site.

pub fn len(&self) -> usize

Number of parameters held.

pub fn is_empty(&self) -> bool

Whether no parameter is held.

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)>

Iterates over the parameters in insertion order.

pub fn build(&self) -> String

Renders the parameters as a query string, empty when there are none.

The result starts with ? so callers can concatenate it onto a path without branching.

Trait Implementations

impl Clone for Query

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl Default for Query

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Query

impl PartialEq for Query

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Query