Skip to main content

QueryParams

Struct QueryParams 

Source
pub struct QueryParams { /* private fields */ }
Expand description

Builder for mixed-type parameter maps.

An iterator of (name, value) pairs is enough when every value converts to the same QueryParam type. Use this builder when the types differ, or when you want to assemble the map incrementally. Binding the same name twice keeps the later value.

§Examples

use chdb_rust::connection::Connection;
use chdb_rust::format::OutputFormat;
use chdb_rust::query_param::QueryParams;

let conn = Connection::open_in_memory()?;
let params = QueryParams::new()
    .bind("x", 5_u64)
    .bind("label", "ok");
let _ = conn.query_with_params(
    "SELECT {x:UInt64} AS x, {label:String} AS label",
    OutputFormat::CSV,
    params,
)?;

Implementations§

Source§

impl QueryParams

Source

pub fn new() -> Self

An empty parameter map.

Passing this to a query that still has {name:Type} placeholders fails with a substitution error. A query with no placeholders runs as a plain query.

Source

pub fn bind(self, name: impl AsRef<str>, value: impl Into<QueryParam>) -> Self

Append a named value and return the map for further binds.

name is the identifier inside {name:Type}. A second bind of the same name replaces the earlier value at query time (last write wins).

Trait Implementations§

Source§

impl Clone for QueryParams

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for QueryParams

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for QueryParams

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<K, V> From<Vec<(K, V)>> for QueryParams
where K: AsRef<str>, V: Into<QueryParam>,

Build a parameter map from an owned vector of pairs.

Source§

fn from(pairs: Vec<(K, V)>) -> Self

Converts to this type from the input type.
Source§

impl<K, V, const N: usize> From<[(K, V); N]> for QueryParams
where K: AsRef<str>, V: Into<QueryParam>,

Build a parameter map from an array literal.

Lets call sites pass [("x", 41_u64)] directly wherever a method takes impl Into<QueryParams>, without naming the builder.

Source§

fn from(pairs: [(K, V); N]) -> Self

Converts to this type from the input type.
Source§

impl IntoIterator for QueryParams

Source§

type Item = (String, QueryParam)

The type of the elements being iterated over.
Source§

type IntoIter = IntoIter<(String, QueryParam)>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl<'a> IntoIterator for &'a QueryParams

Source§

type Item = (&'a str, &'a QueryParam)

The type of the elements being iterated over.
Source§

type IntoIter = Map<Iter<'a, (String, QueryParam)>, fn(&'a (String, QueryParam)) -> (&'a str, &'a QueryParam)>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Allocation for T
where T: RefUnwindSafe + Send + Sync,

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.