Struct UncheckedBind

pub struct UncheckedBind<Query, Value> { /* private fields */ }

Returned by the SqlLiteral::bind() method when binding a value to a fragment of SQL.

Implementations

impl<Query, Value> UncheckedBind<Query, Value>

where Query: Expression,

pub fn sql(self, sql: &str) -> SqlLiteral<Query::SqlType, Self>

Use literal SQL in the query builder.

This function is intended for use when you need a small bit of raw SQL in your query. If you want to write the entire query using raw SQL, use sql_query instead.

Safety

This function should be used with care, as Diesel cannot validate that the value is of the right type nor can it validate that you have passed the correct number of parameters.

Examples

let query = users
    .select(name)
    .filter(
        sql::<Bool>("id > ")
        .bind::<Integer,_>(1)
        .sql(" AND name <> 'Ryan'")
    )
    .get_results(connection);
let expected = vec!["Tess".to_string()];
assert_eq!(Ok(expected), query);

Trait Implementations

impl<Query: Clone, Value: Clone> Clone for UncheckedBind<Query, Value>

fn clone(&self) -> UncheckedBind<Query, Value>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Query: Debug, Value: Debug> Debug for UncheckedBind<Query, Value>

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

Formats the value using the given formatter.

impl<Query, Value> Expression for UncheckedBind<Query, Value>

where Query: Expression,

type SqlType = <Query as Expression>::SqlType

The type that this expression represents in SQL

impl<Q, Value> Query for UncheckedBind<Q, Value>

where Q: Query,

type SqlType = <Q as Query>::SqlType

The SQL type that this query represents.

impl<Query, Value, DB> QueryFragment<DB> for UncheckedBind<Query, Value>

where DB: Backend, Query: QueryFragment<DB>, Value: QueryFragment<DB>,

fn walk_ast<'b>(&'b self, out: AstPass<'_, 'b, DB>) -> QueryResult<()>

Walk over this QueryFragment for all passes.

fn to_sql(&self, out: &mut DB::QueryBuilder, backend: &DB) -> QueryResult<()>

Available on crate feature i-implement-a-third-party-backend-and-opt-into-breaking-changes only.

Converts this QueryFragment to its SQL representation.

fn collect_binds<'b>( &'b self, out: &mut DB::BindCollector<'b>, metadata_lookup: &mut DB::MetadataLookup, backend: &'b DB, ) -> QueryResult<()>

Available on crate feature i-implement-a-third-party-backend-and-opt-into-breaking-changes only.

Serializes all bind parameters in this query.

fn is_safe_to_cache_prepared(&self, backend: &DB) -> QueryResult<bool>

Available on crate feature i-implement-a-third-party-backend-and-opt-into-breaking-changes only.

Is this query safe to store in the prepared statement cache?

fn is_noop(&self, backend: &DB) -> QueryResult<bool>

Available on crate feature i-implement-a-third-party-backend-and-opt-into-breaking-changes only.

Does walking this AST have any effect?

impl<Query: QueryId, Value: QueryId> QueryId for UncheckedBind<Query, Value>

const HAS_STATIC_QUERY_ID: bool = _

Can the SQL generated by Self be uniquely identified by its type?

type QueryId = UncheckedBind<<Query as QueryId>::QueryId, <Value as QueryId>::QueryId>

A type which uniquely represents Self in a SQL query.

fn query_id() -> Option<TypeId>

Returns the type id of Self::QueryId if Self::HAS_STATIC_QUERY_ID. Returns None otherwise.

impl<Query, Value, Conn> RunQueryDsl<Conn> for UncheckedBind<Query, Value>

fn execute(self, conn: &mut Conn) -> QueryResult<usize>

where Conn: Connection, Self: ExecuteDsl<Conn>,

Executes the given command, returning the number of rows affected.

fn load<'query, U>(self, conn: &mut Conn) -> QueryResult<Vec<U>>

where Self: LoadQuery<'query, Conn, U>,

Executes the given query, returning a Vec with the returned rows.

fn load_iter<'conn, 'query: 'conn, U, B>( self, conn: &'conn mut Conn, ) -> QueryResult<Self::RowIter<'conn>>

where U: 'conn, Self: LoadQuery<'query, Conn, U, B> + 'conn,

Executes the given query, returning an Iterator with the returned rows.

fn get_result<'query, U>(self, conn: &mut Conn) -> QueryResult<U>

where Self: LoadQuery<'query, Conn, U>,

Runs the command, and returns the affected row.

fn get_results<'query, U>(self, conn: &mut Conn) -> QueryResult<Vec<U>>

where Self: LoadQuery<'query, Conn, U>,

Runs the command, returning an Vec with the affected rows.

impl<Query, Value, GB> ValidGrouping<GB> for UncheckedBind<Query, Value>

type IsAggregate = Never

Is this expression aggregate?

impl<QS, Query, Value> AppearsOnTable<QS> for UncheckedBind<Query, Value>

where Self: Expression,

impl<Query: Copy, Value: Copy> Copy for UncheckedBind<Query, Value>

impl<QS, Query, Value> SelectableExpression<QS> for UncheckedBind<Query, Value>

where Self: AppearsOnTable<QS>,