Trait c3p0_pg::postgres::types::FromSql

pub trait FromSql {
    fn from_sql(
        ty: &Type, 
        raw: &[u8]
    ) -> Result<Self, Box<dyn Error + 'static + Send + Sync>>;
    fn accepts(ty: &Type) -> bool;

    fn from_sql_null(
        ty: &Type
    ) -> Result<Self, Box<dyn Error + 'static + Send + Sync>> { ... }
    fn from_sql_nullable(
        ty: &Type, 
        raw: Option<&[u8]>
    ) -> Result<Self, Box<dyn Error + 'static + Send + Sync>> { ... }
}

A trait for types that can be created from a Postgres value.

Types

The following implementations are provided by this crate, along with the corresponding Postgres types:

Rust type	Postgres type(s)
bool	BOOL
i8	"char"
i16	SMALLINT, SMALLSERIAL
i32	INT, SERIAL
u32	OID
i64	BIGINT, BIGSERIAL
f32	REAL
f64	DOUBLE PRECISION
String	VARCHAR, CHAR(n), TEXT, CITEXT, NAME, UNKNOWN
Vec<u8>	BYTEA
HashMap<String, Option<String>>	HSTORE

In addition, some implementations are provided for types in third party crates. These are disabled by default; to opt into one of these implementations, activate the Cargo feature corresponding to the crate's name prefixed by with-. For example, the with-serde_json feature enables the implementation for the serde_json::Value type.

Rust type	Postgres type(s)
serialize::json::Json	JSON, JSONB
serde_json::Value	JSON, JSONB
time::Timespec	TIMESTAMP, TIMESTAMP WITH TIME ZONE
chrono::NaiveDateTime	TIMESTAMP
chrono::DateTime<Utc>	TIMESTAMP WITH TIME ZONE
chrono::DateTime<Local>	TIMESTAMP WITH TIME ZONE
chrono::DateTime<FixedOffset>	TIMESTAMP WITH TIME ZONE
chrono::NaiveDate	DATE
chrono::NaiveTime	TIME
eui48::MacAddress	MACADDR
uuid::Uuid	UUID
bit_vec::BitVec	BIT, VARBIT
eui48::MacAddress	MACADDR

Nullability

In addition to the types listed above, FromSql is implemented for Option<T> where T implements FromSql. An Option<T> represents a nullable Postgres value.

Arrays

FromSql is implemented for Vec<T> where T implements FromSql, and corresponds to one-dimensional Postgres arrays.

Required methods

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Self, Box<dyn Error + 'static + Send + Sync>>

Creates a new value of this type from a buffer of data of the specified Postgres Type in its binary format.

The caller of this method is responsible for ensuring that this type is compatible with the Postgres Type.

fn accepts(ty: &Type) -> bool

Determines if a value of this type can be created from the specified Postgres Type.

Loading content...

Provided methods

fn from_sql_null(
    ty: &Type
) -> Result<Self, Box<dyn Error + 'static + Send + Sync>>

Creates a new value of this type from a NULL SQL value.

The caller of this method is responsible for ensuring that this type is compatible with the Postgres Type.

The default implementation returns Err(Box::new(WasNull)).

fn from_sql_nullable(
    ty: &Type,
    raw: Option<&[u8]>
) -> Result<Self, Box<dyn Error + 'static + Send + Sync>>

A convenience function that delegates to from_sql and from_sql_null depending on the value of raw.

Loading content...

Implementations on Foreign Types

impl FromSql for i8

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<i8, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for bool

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<bool, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl<T> FromSql for Option<T> where
    T: FromSql, 

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Option<T>, Box<dyn Error + 'static + Send + Sync>>

fn from_sql_null(
    &Type
) -> Result<Option<T>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for u32

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<u32, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for f64

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<f64, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for Vec<u8>

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<Vec<u8>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for i64

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<i64, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for HashMap<String, Option<String>, RandomState>

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<HashMap<String, Option<String>, RandomState>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl<T> FromSql for Vec<T> where
    T: FromSql, 

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Vec<T>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for i32

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<i32, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for Value

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Value, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for i16

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<i16, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for String

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<String, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl FromSql for f32

fn from_sql(
    &Type,
    raw: &[u8]
) -> Result<f32, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

Loading content...

Implementors

impl<T> FromSql for Date<T> where
    T: FromSql, 

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Date<T>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

impl<T> FromSql for Timestamp<T> where
    T: FromSql, 

fn from_sql(
    ty: &Type,
    raw: &[u8]
) -> Result<Timestamp<T>, Box<dyn Error + 'static + Send + Sync>>

fn accepts(ty: &Type) -> bool

Loading content...