Trait postgres_types::FromSql

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

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

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 typePostgres type(s)
boolBOOL
i8“char”
i16SMALLINT, SMALLSERIAL
i32INT, SERIAL
u32OID
i64BIGINT, BIGSERIAL
f32REAL
f64DOUBLE PRECISION
&str/StringVARCHAR, CHAR(n), TEXT, CITEXT, NAME, UNKNOWN
LTREE, LQUERY, LTXTQUERY
&[u8]/Vec<u8>BYTEA
HashMap<String, Option<String>>HSTORE
SystemTimeTIMESTAMP, TIMESTAMP WITH TIME ZONE
IpAddrINET

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-1 feature enables the implementation for the serde_json::Value type.

Rust typePostgres type(s)
chrono::NaiveDateTimeTIMESTAMP
chrono::DateTime<Utc>TIMESTAMP WITH TIME ZONE
chrono::DateTime<Local>TIMESTAMP WITH TIME ZONE
chrono::DateTime<FixedOffset>TIMESTAMP WITH TIME ZONE
chrono::NaiveDateDATE
chrono::NaiveTimeTIME
time::PrimitiveDateTimeTIMESTAMP
time::OffsetDateTimeTIMESTAMP WITH TIME ZONE
time::DateDATE
time::TimeTIME
jiff::civil::DateDATE
jiff::civil::DateTimeTIMESTAMP
jiff::civil::TimeTIME
jiff::TimestampTIMESTAMP WITH TIME ZONE
eui48::MacAddressMACADDR
geo_types::Point<f64>POINT
geo_types::Rect<f64>BOX
geo_types::LineString<f64>PATH
serde_json::ValueJSON, JSONB
uuid::UuidUUID
bit_vec::BitVecBIT, VARBIT
eui48::MacAddressMACADDR
cidr::InetCidrCIDR
cidr::InetAddrINET
smol_str::SmolStrVARCHAR, CHAR(n), TEXT, CITEXT,
NAME, UNKNOWN, LTREE, LQUERY,
LTXTQUERY

§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>, Box<[T]> and [T; N] where T implements FromSql, and corresponds to one-dimensional Postgres arrays.

Note: the impl for arrays only exist when the Cargo feature array-impls is enabled.

Required Methods§

source

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

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.

source

fn accepts(ty: &Type) -> bool

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

Provided Methods§

source

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

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

source

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

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

Object Safety§

This trait is not object safe.

Implementations on Foreign Types§

source§

impl<'a> FromSql<'a> for &'a str

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for &'a [u8]

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for IpAddr

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for bool

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for f32

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for f64

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for i8

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for i16

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for i32

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for i64

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for u32

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for Box<str>

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for String

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for Vec<u8>

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a> FromSql<'a> for SystemTime

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a, S> FromSql<'a> for HashMap<String, Option<String>, S>
where S: Default + BuildHasher,

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a, T: FromSql<'a>> FromSql<'a> for Option<T>

source§

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

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a, T: FromSql<'a>> FromSql<'a> for Box<[T]>

source§

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

source§

fn accepts(ty: &Type) -> bool

source§

impl<'a, T: FromSql<'a>> FromSql<'a> for Vec<T>

source§

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

source§

fn accepts(ty: &Type) -> bool

Implementors§

source§

impl<'a> FromSql<'a> for PgLsn

source§

impl<'a, T: FromSql<'a>> FromSql<'a> for Date<T>

source§

impl<'a, T: FromSql<'a>> FromSql<'a> for Timestamp<T>