Struct OwnedValue 

pub struct OwnedValue { /* private fields */ }

An owned standalone duckdb_value (destroyed once on drop) with introspection.

Implementations

impl OwnedValue

pub fn is_null(&self) -> bool

Whether the value’s type is SQL NULL.

pub fn to_sql_string(&self) -> Option<String>

The value’s SQL string rendering (e.g. 42, 'text'), or None if DuckDB produces none.

pub fn struct_child(&self, index: u64) -> Option<OwnedValue>

The child field at index of a STRUCT value, as an owned OwnedValue, or None if out of range (or the value is not a struct).

pub fn get_hugeint(&self) -> Result<i128, DuckDBConversionError>

The HUGEINT value as an i128.

Errors

Errors if the value is not a HUGEINT.

pub fn get_uhugeint(&self) -> Result<u128, DuckDBConversionError>

The UHUGEINT value as a u128.

Errors

Errors if the value is not a UHUGEINT.

pub fn get_date_days(&self) -> Result<i32, DuckDBConversionError>

The DATE value as a day count since the epoch (1970-01-01).

Errors

Errors if the value is not a DATE.

pub fn get_time_micros(&self) -> Result<i64, DuckDBConversionError>

The TIME value as microseconds since midnight.

Errors

Errors if the value is not a TIME.

pub fn get_time_ns_nanos(&self) -> Result<i64, DuckDBConversionError>

The TIME_NS value as nanoseconds since midnight.

Errors

Errors if the value is not a TIME_NS.

pub fn get_time_tz_bits(&self) -> Result<u64, DuckDBConversionError>

The TIME WITH TIME ZONE value as its packed 64-bit representation (micros + offset bits, per DuckDB’s duckdb_time_tz layout).

Errors

Errors if the value is not a TIME_TZ.

pub fn get_timestamp_micros(&self) -> Result<i64, DuckDBConversionError>

The TIMESTAMP value as microseconds since the epoch.

Errors

Errors if the value is not a TIMESTAMP.

pub fn get_timestamp_tz_micros(&self) -> Result<i64, DuckDBConversionError>

The TIMESTAMP WITH TIME ZONE value as microseconds since the epoch (UTC).

Errors

Errors if the value is not a TIMESTAMP_TZ.

pub fn get_timestamp_seconds(&self) -> Result<i64, DuckDBConversionError>

The TIMESTAMP_S value as seconds since the epoch.

Errors

Errors if the value is not a TIMESTAMP_S.

pub fn get_timestamp_millis(&self) -> Result<i64, DuckDBConversionError>

The TIMESTAMP_MS value as milliseconds since the epoch.

Errors

Errors if the value is not a TIMESTAMP_MS.

pub fn get_timestamp_nanos(&self) -> Result<i64, DuckDBConversionError>

The TIMESTAMP_NS value as nanoseconds since the epoch.

Errors

Errors if the value is not a TIMESTAMP_NS.

pub fn get_interval(&self) -> Result<IntervalParts, DuckDBConversionError>

The INTERVAL value as its (months, days, micros) parts.

Errors

Errors if the value is not an INTERVAL.

pub fn get_uuid(&self) -> Result<DuckUuid, DuckDBConversionError>

The UUID value.

Errors

Errors if the value is not a UUID.

Trait Implementations

impl Drop for OwnedValue

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.