Struct Query 

pub struct Query<Args> { /* private fields */ }

A DQL query string with its arguments

Most APIs in the Ditto SDK don’t take a Query directly, but instead take a generic parameter that implements IntoQuery, a trait implemented by types that can be turned into a Query.

Common examples are:

• String (and string-like types)
• (String, Args) where Args is anything that implements Serialize

let select_query = "SELECT * FROM cars".into_query();

let insert_query = (
    "INSERT INTO cars DOCUMENTS (:doc)",
    json!({"doc": {"foo": "bar"}}),
).into_query();

The Args type

This type is generic over its arguments, with the requirement that the arguments must:

• implement Serialize
• serialize to a map-like type (e.g. serde_json::json!({"some": "object"}) or HashMap, not a String)

If the arguments are mutated using interior mutability, the result is not specified and may cause logic errors. Note that this is not undefined behaviour, since any errors will be confined to this instance of Query.

When no arguments are provided, the Args type defaults to ()

Trait Implementations

impl<Args: Clone> Clone for Query<Args>

fn clone(&self) -> Query<Args>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Args: Debug> Debug for Query<Args>

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

Formats the value using the given formatter.

impl<A> IntoQuery for Query<A>

A query implements IntoQuery :)

type Args = A

The type of the arguments provided with this query

fn into_query(self) -> Result<Query<Self::Args>, DittoError>

Convert this object into a Query

impl<Args: PartialEq> PartialEq for Query<Args>

fn eq(&self, other: &Query<Args>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Args> StructuralPartialEq for Query<Args>