Struct diesel::query_builder::insert_statement::InsertStatement

pub struct InsertStatement<T, U, Op = Insert, Ret = NoReturningClause> { /* fields omitted */ }

Methods

impl<T, U, Op> InsertStatement<T, U, Op>

fn no_returning_clause(target: T, records: U, operator: Op) -> Self

impl<T, U, Op, Ret> InsertStatement<T, U, Op, Ret>

fn new(target: T, records: U, operator: Op, returning: Ret) -> Self

impl<T, U, Op> InsertStatement<T, U, Op, NoReturningClause>

fn returning<E>(
    self,
    returns: E
) -> InsertStatement<T, U, Op, ReturningClause<E>> where
    InsertStatement<T, U, Op, ReturningClause<E>>: Query, 

Specify what expression is returned after execution of the insert. This method can only be called once.

Examples

Inserting a record:

let new_user = NewUser {
    name: "Timmy".to_string(),
};

let inserted_name = diesel::insert(&new_user)
    .into(users)
    .returning(name)
    .get_result(&connection);
assert_eq!(Ok("Timmy".to_string()), inserted_name);

Trait Implementations

impl<T: Debug, U: Debug, Op: Debug, Ret: Debug> Debug for InsertStatement<T, U, Op, Ret>

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<T: Copy, U: Copy, Op: Copy, Ret: Copy> Copy for InsertStatement<T, U, Op, Ret>

impl<T: Clone, U: Clone, Op: Clone, Ret: Clone> Clone for InsertStatement<T, U, Op, Ret>

fn clone(&self) -> InsertStatement<T, U, Op, Ret>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, U, Op, Ret, DB> QueryFragment<DB> for InsertStatement<T, U, Op, Ret> where
    DB: Backend,
    T: Table,
    T::FromClause: QueryFragment<DB>,
    U: Insertable<T, DB> + Copy,
    Op: QueryFragment<DB>,
    Ret: QueryFragment<DB>, 

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

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

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

fn is_safe_to_cache_prepared(&self) -> QueryResult<bool>

impl<T, U, Op, Ret> QueryId for InsertStatement<T, U, Op, Ret>

type QueryId = ()

fn has_static_query_id() -> bool

fn query_id() -> Option<TypeId>

impl<T, U, Op> AsQuery for InsertStatement<T, U, Op, NoReturningClause> where
    T: Table,
    InsertStatement<T, U, Op, ReturningClause<T::AllColumns>>: Query, 

type SqlType = <Self::Query as Query>::SqlType

type Query = InsertStatement<T, U, Op, ReturningClause<T::AllColumns>>

fn as_query(self) -> Self::Query

impl<T, U, Op, Ret> Query for InsertStatement<T, U, Op, ReturningClause<Ret>> where
    Ret: Expression + SelectableExpression<T> + NonAggregate, 

type SqlType = Ret::SqlType