Enum OwnedPostgresValue 

pub enum OwnedPostgresValue {
    Smallint(i16),
    Integer(i32),
    Bigint(i64),
    Real(f32),
    DoublePrecision(f64),
    Text(String),
    Bytea(Vec<u8>),
    Boolean(bool),
    Array(Vec<Self>),
    Enum(Box<dyn PostgresEnum>),
    Null,
}

A PostgresValue that owns its data, so it has no lifetime.

Use it to store values beyond the query that produced them, for example in an owned prepared statement. Convert with From in either direction.

Examples

use drizzle_postgres::values::{OwnedPostgresValue, PostgresValue};

let owned = OwnedPostgresValue::from(PostgresValue::from("hello"));
assert_eq!(owned.as_str(), Some("hello"));
assert_eq!(owned.as_value().as_str(), Some("hello"));

Variants

Smallint(i16)

SMALLINT values (16-bit signed integer)

Integer(i32)

INTEGER values (32-bit signed integer)

Bigint(i64)

BIGINT values (64-bit signed integer)

Real(f32)

REAL values (32-bit floating point)

DoublePrecision(f64)

DOUBLE PRECISION values (64-bit floating point)

Text(String)

TEXT, VARCHAR, CHAR values (owned)

Bytea(Vec<u8>)

BYTEA values (owned binary data)

Boolean(bool)

BOOLEAN values

Array(Vec<Self>)

Array of any PostgreSQL type

Enum(Box<dyn PostgresEnum>)

PostgreSQL ENUM values (native enum types via CREATE TYPE ... AS ENUM)

Null

NULL value

Implementations

impl OwnedPostgresValue

pub const fn is_null(&self) -> bool

Returns true if this value is NULL.

pub const fn as_bool(&self) -> Option<bool>

Returns the boolean value if this is BOOLEAN.

pub const fn as_i16(&self) -> Option<i16>

Returns the i16 value if this is SMALLINT.

pub const fn as_i32(&self) -> Option<i32>

Returns the i32 value if this is INTEGER.

pub const fn as_i64(&self) -> Option<i64>

Returns the i64 value if this is BIGINT.

pub const fn as_f32(&self) -> Option<f32>

Returns the f32 value if this is REAL.

pub const fn as_f64(&self) -> Option<f64>

Returns the f64 value if this is DOUBLE PRECISION.

pub const fn as_str(&self) -> Option<&str>

Returns the text value if this is TEXT.

pub fn as_bytes(&self) -> Option<&[u8]>

Returns the bytea value if this is BYTEA.

pub fn as_array(&self) -> Option<&[Self]>

Returns the array elements if this is an ARRAY.

pub fn as_value(&self) -> PostgresValue<'_>

Returns a borrowed PostgresValue view of this owned value.

pub fn convert<T: FromPostgresValue>(self) -> Result<T, DrizzleError>

Converts the value into a Rust type through FromPostgresValue.

Behaves like PostgresValue::convert.

Errors

Returns DrizzleError::ConversionError when T cannot hold the stored value.

pub fn convert_ref<T: FromPostgresValue>(&self) -> Result<T, DrizzleError>

Like convert, but borrows the value (cloning data where T needs it).

Errors

Returns DrizzleError::ConversionError when T cannot hold the stored value.

Trait Implementations

impl Clone for OwnedPostgresValue

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedPostgresValue

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

Formats the value using the given formatter.

impl Default for OwnedPostgresValue

fn default() -> Self

Returns the “default value” for a type.

impl Display for OwnedPostgresValue

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

Formats the value using the given formatter.

impl<'a> From<&'a OwnedPostgresValue> for Cow<'a, OwnedPostgresValue>

fn from(value: &'a OwnedPostgresValue) -> Self

Converts to this type from the input type.

impl<'a> From<&'a OwnedPostgresValue> for PostgresValue<'a>

fn from(value: &'a OwnedPostgresValue) -> Self

Converts to this type from the input type.

impl From<&Arc<String>> for OwnedPostgresValue

fn from(value: &Arc<String>) -> Self

Converts to this type from the input type.

impl From<&Arc<Vec<u8>>> for OwnedPostgresValue

fn from(value: &Arc<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<&Arc<str>> for OwnedPostgresValue

fn from(value: &Arc<str>) -> Self

Converts to this type from the input type.

impl From<&Box<String>> for OwnedPostgresValue

fn from(value: &Box<String>) -> Self

Converts to this type from the input type.

impl From<&Box<Vec<u8>>> for OwnedPostgresValue

fn from(value: &Box<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<&Box<str>> for OwnedPostgresValue

fn from(value: &Box<str>) -> Self

Converts to this type from the input type.

impl<'a> From<&PostgresValue<'a>> for OwnedPostgresValue

fn from(value: &PostgresValue<'a>) -> Self

Converts to this type from the input type.

impl From<&Rc<String>> for OwnedPostgresValue

fn from(value: &Rc<String>) -> Self

Converts to this type from the input type.

impl From<&Rc<Vec<u8>>> for OwnedPostgresValue

fn from(value: &Rc<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<&Rc<str>> for OwnedPostgresValue

fn from(value: &Rc<str>) -> Self

Converts to this type from the input type.

impl From<&String> for OwnedPostgresValue

fn from(value: &String) -> Self

Converts to this type from the input type.

impl From<&str> for OwnedPostgresValue

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<Arc<String>> for OwnedPostgresValue

fn from(value: Arc<String>) -> Self

Converts to this type from the input type.

impl From<Arc<Vec<u8>>> for OwnedPostgresValue

fn from(value: Arc<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<Arc<str>> for OwnedPostgresValue

fn from(value: Arc<str>) -> Self

Converts to this type from the input type.

impl From<Box<String>> for OwnedPostgresValue

fn from(value: Box<String>) -> Self

Converts to this type from the input type.

impl From<Box<Vec<u8>>> for OwnedPostgresValue

fn from(value: Box<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<Box<str>> for OwnedPostgresValue

fn from(value: Box<str>) -> Self

Converts to this type from the input type.

impl From<OwnedPostgresValue> for SQL<'_, OwnedPostgresValue>

fn from(value: OwnedPostgresValue) -> Self

Converts to this type from the input type.

impl From<OwnedPostgresValue> for Cow<'_, OwnedPostgresValue>

fn from(value: OwnedPostgresValue) -> Self

Converts to this type from the input type.

impl From<OwnedPostgresValue> for PostgresValue<'_>

fn from(value: OwnedPostgresValue) -> Self

Converts to this type from the input type.

impl<'a> From<PostgresValue<'a>> for OwnedPostgresValue

fn from(value: PostgresValue<'a>) -> Self

Converts to this type from the input type.

impl From<Rc<String>> for OwnedPostgresValue

fn from(value: Rc<String>) -> Self

Converts to this type from the input type.

impl From<Rc<Vec<u8>>> for OwnedPostgresValue

fn from(value: Rc<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<Rc<str>> for OwnedPostgresValue

fn from(value: Rc<str>) -> Self

Converts to this type from the input type.

impl From<String> for OwnedPostgresValue

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for OwnedPostgresValue

fn from(value: Vec<u8>) -> Self

Converts to this type from the input type.

impl From<bool> for OwnedPostgresValue

fn from(value: bool) -> Self

Converts to this type from the input type.

impl From<f32> for OwnedPostgresValue

fn from(value: f32) -> Self

Converts to this type from the input type.

impl From<f64> for OwnedPostgresValue

fn from(value: f64) -> Self

Converts to this type from the input type.

impl From<i16> for OwnedPostgresValue

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for OwnedPostgresValue

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for OwnedPostgresValue

fn from(value: i64) -> Self

Converts to this type from the input type.

impl PartialEq for OwnedPostgresValue

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl SQLParam for OwnedPostgresValue

fn pagination_param(value: usize) -> Option<Self>

Binds LIMIT/OFFSET values as BIGINT parameters so paginated queries share one SQL text (and one cached prepared statement) across pages.

const DIALECT: Dialect = drizzle_core::Dialect::PostgreSQL

The dialect, at runtime.

type DialectMarker = PostgresDialect

The dialect, as a type (SQLiteDialect, PostgresDialect or MySQLDialect).

fn write_literal(&self, buf: &mut String) -> bool

Appends this value to buf as a SQL literal of this dialect.

impl StructuralPartialEq for OwnedPostgresValue

impl TryFrom<OwnedPostgresValue> for i16

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for i32

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for i64

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for f32

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for f64

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for String

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Box<String>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Rc<String>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Arc<String>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Box<str>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Rc<str>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Arc<str>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Vec<u8>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Box<Vec<u8>>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Rc<Vec<u8>>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for Arc<Vec<u8>>

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OwnedPostgresValue> for bool

type Error = DrizzleError

The type returned in the event of a conversion error.

fn try_from(value: OwnedPostgresValue) -> Result<Self, Self::Error>

Performs the conversion.