Struct QueryV2

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

A DQL query string with its arguments

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

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 QueryV2.

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

Trait Implementations

impl<Args: Clone> Clone for QueryV2<Args>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Args: Debug> Debug for QueryV2<Args>

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

Formats the value using the given formatter.

impl<A> IntoQuery for QueryV2<A>

A query implements IntoQuery :)

type Args = A

The type of the arguments provided with this query

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

Convert this object into a QueryV2

impl<Args: PartialEq> PartialEq for QueryV2<Args>

fn eq(&self, other: &QueryV2<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 QueryV2<Args>