Enum QueryValue 

#[non_exhaustive]
pub enum QueryValue {
    Text(String),
    TextRaw {
        bytes: Vec<u8>,
        csfrm: u8,
    },
    Raw(Vec<u8>),
    Rowid(String),
    BinaryDouble(String),
    IntervalDS {
        days: i32,
        hours: i32,
        minutes: i32,
        seconds: i32,
        fseconds: i32,
    },
    IntervalYM {
        years: i32,
        months: i32,
    },
    Number(OracleNumber),
    Boolean(bool),
    Cursor(Box<CursorValue>),
    DateTime {
        year: i32,
        month: u8,
        day: u8,
        hour: u8,
        minute: u8,
        second: u8,
        nanosecond: u32,
    },
    TimestampTz {
        year: i32,
        month: u8,
        day: u8,
        hour: u8,
        minute: u8,
        second: u8,
        nanosecond: u32,
        offset_minutes: i32,
    },
    Object(Box<ObjectValue>),
    Lob(Box<LobValue>),
    Vector(Box<Vector>),
    Json(Box<OsonValue>),
    Array(Vec<Option<QueryValue>>),
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Text(String)

TextRaw

Character data that could not be decoded as valid text; the raw bytes are preserved so the caller can apply an encoding_errors policy.

Fields

bytes: Vec<u8>

csfrm: u8

Raw(Vec<u8>)

Rowid(String)

BinaryDouble(String)

IntervalDS

Fields

days: i32

hours: i32

minutes: i32

seconds: i32

fseconds: i32

IntervalYM

Fields

years: i32

months: i32

Number(OracleNumber)

Oracle NUMBER / BINARY_INTEGER. The lossless decimal value is carried inline as a { coefficient: i128, scale: i16 } form (no per-cell heap allocation for the common case), with a boxed text fallback for the rare value that does not fit inline. See OracleNumber.

Boolean(bool)

Native Oracle DB_TYPE_BOOLEAN (ora_type_num 252, 23ai+): surfaced as a Python bool rather than an integer.

Cursor(Box<CursorValue>)

REF CURSOR (cold): payload boxed, see CursorValue.

DateTime

Fields

year: i32

month: u8

day: u8

hour: u8

minute: u8

second: u8

nanosecond: u32

TimestampTz

Fields

year: i32

month: u8

day: u8

hour: u8

minute: u8

second: u8

nanosecond: u32

offset_minutes: i32

Object(Box<ObjectValue>)

ADT / collection image (cold): payload boxed, see ObjectValue.

Lob(Box<LobValue>)

LOB / BFILE locator (cold): payload boxed, see LobValue.

Vector(Box<Vector>)

VECTOR (cold): the per-element data is boxed out of the hot enum.

Json(Box<OsonValue>)

Native Oracle JSON (DB_TYPE_JSON, ora_type_num 119): the OSON image is decoded eagerly into the lossless crate::oson::OsonValue tree (cold): the tree is boxed out of the hot enum.

Array(Vec<Option<QueryValue>>)

Implementations

impl QueryValue

pub fn number_from_text(text: &str, is_integer: bool) -> Self

Construct a NUMBER value from already-canonical decimal text and an explicit is_integer flag. Convenience for binds / tests that hold the canonical text; folds into the inline form when it fits. The text MUST be canonical Oracle NUMBER text (the form the decoder emits).

pub fn as_text(&self) -> Option<&str>

Borrow this value as decoded text when it is a VARCHAR2 / CHAR / NVARCHAR2 / CLOB-inlined string, otherwise None. Convenience accessor for callers that want to avoid matching the full enum.

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

Interpret this value as a 64-bit integer. Works for NUMBER values whose canonical text parses as an i64, and for the native DB_TYPE_BOOLEAN (true -> 1, false -> 0). Returns None for any other variant, or a NUMBER that does not fit / is not integral.

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

Interpret this value as an f64. Works for NUMBER, BINARY_DOUBLE and BINARY_FLOAT (all carried as canonical text), otherwise None.

pub fn as_number_text(&self) -> Option<Cow<'_, str>>

The canonical decimal text of a NUMBER value (lossless, arbitrary precision), otherwise None. The owned inline form synthesizes the text on demand via the shared formatter, so this returns an owned Cow.

pub fn as_number(&self) -> Option<&OracleNumber>

Borrow the inline NUMBER representation, otherwise None.

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

Return the boolean of a native DB_TYPE_BOOLEAN value, otherwise None.

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

Borrow the bytes of a RAW value, otherwise None.

pub fn as_rowid(&self) -> Option<&str>

Borrow the encoded text of a ROWID / UROWID value, otherwise None.

pub fn variant_name(&self) -> &'static str

A short, stable name for this value’s variant (e.g. "Text", "Number"). Lets callers identify a fetched cell’s shape for logging / diagnostics without an exhaustive match that would break the moment a variant is added. The match lives inside the defining crate, so it stays the single exhaustiveness tripwire that flags a new variant at compile time.

Trait Implementations

impl Clone for QueryValue

fn clone(&self) -> QueryValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryValue

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

Formats the value using the given formatter.

impl PartialEq for QueryValue

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for QueryValue