[−][src]Trait diesel::serialize::ToSql
Serializes a single value to be sent to the database.
The output is sent as a bind parameter, and the data must be written in the expected format for the given backend.
When possible, implementations of this trait should prefer using an existing
implementation, rather than writing to out
directly. (For example, if you
are implementing this for an enum, which is represented as an integer in the
database, you should use i32::to_sql(x, out)
instead of writing to out
yourself.
Any types which implement this trait should also #[derive(AsExpression)]
.
Backend specific details
- For PostgreSQL, the bytes will be sent using the binary protocol, not text.
- For SQLite, all implementations should be written in terms of an existing
ToSql
implementation. - For MySQL, the expected bytes will depend on the return value of
type_metadata
for the given SQL type. SeeMysqlType
for details. - For third party backends, consult that backend's documentation.
Examples
Most implementations of this trait will be defined in terms of an existing implementation.
#[repr(i32)] #[derive(Debug, Clone, Copy)] pub enum MyEnum { A = 1, B = 2, } impl<DB> ToSql<Integer, DB> for MyEnum where DB: Backend, i32: ToSql<Integer, DB>, { fn to_sql<W: Write>(&self, out: &mut Output<W, DB>) -> serialize::Result { (*self as i32).to_sql(out) } }
Required methods
Loading content...Implementations on Foreign Types
impl<'a, A, T: ?Sized, DB> ToSql<A, DB> for &'a T where
DB: Backend,
T: ToSql<A, DB>,
[src]
DB: Backend,
T: ToSql<A, DB>,
impl ToSql<Datetime, Mysql> for MYSQL_TIME
[src]
impl ToSql<Timestamp, Mysql> for MYSQL_TIME
[src]
impl ToSql<Time, Mysql> for MYSQL_TIME
[src]
impl ToSql<Date, Mysql> for MYSQL_TIME
[src]
impl ToSql<Datetime, Mysql> for NaiveDateTime
[src]
impl ToSql<Timestamp, Mysql> for NaiveDateTime
[src]
impl ToSql<Time, Mysql> for NaiveTime
[src]
impl ToSql<Date, Mysql> for NaiveDate
[src]
impl ToSql<TinyInt, Mysql> for i8
[src]
impl ToSql<Unsigned<TinyInt>, Mysql> for u8
[src]
impl ToSql<Unsigned<SmallInt>, Mysql> for u16
[src]
impl ToSql<Unsigned<Integer>, Mysql> for u32
[src]
impl ToSql<Unsigned<BigInt>, Mysql> for u64
[src]
impl ToSql<Bool, Mysql> for bool
[src]
impl<__DB> ToSql<Nullable<Timestamp>, __DB> for SystemTime where
__DB: Backend,
Self: ToSql<Timestamp, __DB>,
[src]
__DB: Backend,
Self: ToSql<Timestamp, __DB>,
impl<__DB> ToSql<Nullable<Date>, __DB> for NaiveDate where
__DB: Backend,
Self: ToSql<Date, __DB>,
[src]
__DB: Backend,
Self: ToSql<Date, __DB>,
impl<__DB> ToSql<Nullable<Time>, __DB> for NaiveTime where
__DB: Backend,
Self: ToSql<Time, __DB>,
[src]
__DB: Backend,
Self: ToSql<Time, __DB>,
impl<__DB> ToSql<Nullable<Timestamp>, __DB> for NaiveDateTime where
__DB: Backend,
Self: ToSql<Timestamp, __DB>,
[src]
__DB: Backend,
Self: ToSql<Timestamp, __DB>,
impl<__DB> ToSql<Nullable<Datetime>, __DB> for NaiveDateTime where
__DB: Backend,
Self: ToSql<Datetime, __DB>,
[src]
__DB: Backend,
Self: ToSql<Datetime, __DB>,
impl<DB: Backend> ToSql<Float, DB> for f32
[src]
impl<DB: Backend> ToSql<Double, DB> for f64
[src]
impl<DB: Backend> ToSql<SmallInt, DB> for i16
[src]
impl<DB: Backend> ToSql<Integer, DB> for i32
[src]
impl<DB: Backend> ToSql<BigInt, DB> for i64
[src]
impl<T, ST, DB> ToSql<Nullable<ST>, DB> for Option<T> where
T: ToSql<ST, DB>,
DB: Backend,
ST: NotNull,
[src]
T: ToSql<ST, DB>,
DB: Backend,
ST: NotNull,
impl<__DB> ToSql<Nullable<Bool>, __DB> for bool where
__DB: Backend,
Self: ToSql<Bool, __DB>,
[src]
__DB: Backend,
Self: ToSql<Bool, __DB>,
impl<__DB> ToSql<Nullable<TinyInt>, __DB> for i8 where
__DB: Backend,
Self: ToSql<TinyInt, __DB>,
[src]
__DB: Backend,
Self: ToSql<TinyInt, __DB>,
impl<__DB> ToSql<Nullable<SmallInt>, __DB> for i16 where
__DB: Backend,
Self: ToSql<SmallInt, __DB>,
[src]
__DB: Backend,
Self: ToSql<SmallInt, __DB>,
impl<__DB> ToSql<Nullable<Integer>, __DB> for i32 where
__DB: Backend,
Self: ToSql<Integer, __DB>,
[src]
__DB: Backend,
Self: ToSql<Integer, __DB>,
impl<__DB> ToSql<Nullable<BigInt>, __DB> for i64 where
__DB: Backend,
Self: ToSql<BigInt, __DB>,
[src]
__DB: Backend,
Self: ToSql<BigInt, __DB>,
impl<__DB> ToSql<Nullable<Unsigned<TinyInt>>, __DB> for u8 where
__DB: Backend,
Self: ToSql<Unsigned<TinyInt>, __DB>,
[src]
__DB: Backend,
Self: ToSql<Unsigned<TinyInt>, __DB>,
impl<__DB> ToSql<Nullable<Unsigned<SmallInt>>, __DB> for u16 where
__DB: Backend,
Self: ToSql<Unsigned<SmallInt>, __DB>,
[src]
__DB: Backend,
Self: ToSql<Unsigned<SmallInt>, __DB>,
impl<__DB> ToSql<Nullable<Unsigned<Integer>>, __DB> for u32 where
__DB: Backend,
Self: ToSql<Unsigned<Integer>, __DB>,
[src]
__DB: Backend,
Self: ToSql<Unsigned<Integer>, __DB>,
impl<__DB> ToSql<Nullable<Unsigned<BigInt>>, __DB> for u64 where
__DB: Backend,
Self: ToSql<Unsigned<BigInt>, __DB>,
[src]
__DB: Backend,
Self: ToSql<Unsigned<BigInt>, __DB>,
impl<__DB> ToSql<Nullable<Float>, __DB> for f32 where
__DB: Backend,
Self: ToSql<Float, __DB>,
[src]
__DB: Backend,
Self: ToSql<Float, __DB>,
impl<__DB> ToSql<Nullable<Double>, __DB> for f64 where
__DB: Backend,
Self: ToSql<Double, __DB>,
[src]
__DB: Backend,
Self: ToSql<Double, __DB>,
impl<__DB> ToSql<Nullable<Text>, __DB> for String where
__DB: Backend,
Self: ToSql<Text, __DB>,
[src]
__DB: Backend,
Self: ToSql<Text, __DB>,
impl<__DB> ToSql<Nullable<Text>, __DB> for str where
__DB: Backend,
Self: ToSql<Text, __DB>,
[src]
__DB: Backend,
Self: ToSql<Text, __DB>,
impl<__DB> ToSql<Nullable<Binary>, __DB> for Vec<u8> where
__DB: Backend,
Self: ToSql<Binary, __DB>,
[src]
__DB: Backend,
Self: ToSql<Binary, __DB>,
impl<__DB> ToSql<Nullable<Binary>, __DB> for [u8] where
__DB: Backend,
Self: ToSql<Binary, __DB>,
[src]
__DB: Backend,
Self: ToSql<Binary, __DB>,
impl<DB: Backend> ToSql<Text, DB> for str
[src]
impl<DB> ToSql<Text, DB> for String where
DB: Backend,
str: ToSql<Text, DB>,
[src]
DB: Backend,
str: ToSql<Text, DB>,
impl<DB> ToSql<Binary, DB> for Vec<u8> where
DB: Backend,
[u8]: ToSql<Binary, DB>,
[src]
DB: Backend,
[u8]: ToSql<Binary, DB>,
impl<DB: Backend> ToSql<Binary, DB> for [u8]
[src]
impl<'a, T: ?Sized, ST, DB> ToSql<ST, DB> for Cow<'a, T> where
T: 'a + ToOwned + ToSql<ST, DB>,
DB: Backend,
Self: Debug,
[src]
Loading content...
T: 'a + ToOwned + ToSql<ST, DB>,
DB: Backend,
Self: Debug,