Struct Query

pub struct Query<'r, C: Connection> { /* private fields */ }

A query future

Implementations

impl<'r, C> Query<'r, C>

where C: Connection,

pub fn into_owned(self) -> Query<'static, C>

Converts to an owned type which can easily be moved to a different thread

impl<C> Query<'_, C>

where C: Connection,

pub fn query(self, surql: impl IntoQuery) -> Self

Chains a query onto an existing query

pub const fn with_stats(self) -> WithStats<Self>

Return query statistics along with its results

pub fn bind(self, bindings: impl Serialize + 'static) -> Self

Binds a parameter or parameters to a query

Examples

Binding a key/value tuple

let response = db.query("CREATE user SET name = $name")
    .bind(("name", "John Doe"))
    .await?;

Binding an object

use serde::Serialize;

#[derive(Serialize)]
struct User<'a> {
    name: &'a str,
}

let response = db.query("CREATE user SET name = $name")
    .bind(User {
        name: "John Doe",
    })
    .await?;

Trait Implementations

impl<'r, C: Debug + Connection> Debug for Query<'r, C>

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

Formats the value using the given formatter.

impl<'r, Client> IntoFuture for Query<'r, Client>

where Client: Connection,

type Output = Result<Response, Error>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <Query<'r, Client> as IntoFuture>::Output> + Sync + Send + 'r>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.