Enum QueryValueRef 

#[non_exhaustive]
pub enum QueryValueRef<'buf> {
    Text(&'buf str),
    Raw(&'buf [u8]),
    Number {
        text: &'buf str,
        is_integer: bool,
    },
    Boolean(bool),
    IntervalDS {
        days: i32,
        hours: i32,
        minutes: i32,
        seconds: i32,
        fseconds: i32,
    },
    IntervalYM {
        years: i32,
        months: i32,
    },
    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,
    },
    Owned(&'buf QueryValue),
}

A borrowed, zero-copy mirror of the hot scalar QueryValue variants whose payload lives inside the fetch decode buffer (the network response Vec<u8>). A consumer iterating a fetched row batch via the borrowed path receives QueryValueRef<'buf> values that point straight at the wire bytes — the common scalar case pays zero per-cell allocations, in contrast to the owned QueryValue path which materializes a String/Vec<u8> for every column of every row.

What is and is not borrowed

• Text / Raw borrow a contiguous slice of the wire buffer directly: the common single-chunk VARCHAR2/CHAR/RAW value costs nothing.
• Number borrows the canonically reformatted decimal text. Oracle’s NUMBER is not stored as ASCII on the wire, so the borrowed path decodes it into a scratch arena the batch owns (see the borrowed fetch API) and borrows from there — still zero per-cell heap allocation, the arena grows amortized across the batch.
• Boolean / IntervalDS / IntervalYM / DateTime are tiny Copy values decoded from the wire bytes; they never touched the heap on the owned path either.
• The cold variants (Cursor, Object, Lob, Vector, Json) and the rare UTF-16 (NCHAR) text / synthesized ROWID / BinaryDouble cases cannot be borrowed losslessly from the wire, so they fall back to an owned boxed QueryValue (the QueryValueRef::Owned variant). These are the uncommon path; the hot scalar grid stays borrowed.

Copy + small: the enum holds borrowed scalars and small Copy payloads only (cold values live behind the boxed Owned pointer), so a row of QueryValueRef is a flat, cache-friendly slice. Convert to the owned form with QueryValueRef::to_owned_value.

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(&'buf str)

Decoded text borrowing the wire buffer (single-chunk VARCHAR2 / CHAR / LONG that decoded as valid UTF-8).

Raw(&'buf [u8])

RAW / LONG_RAW bytes borrowing the wire buffer (single chunk).

Number

Canonical decimal text of a NUMBER, borrowed from the batch’s number scratch arena (the wire form is binary, so it is reformatted once).

Fields

text: &'buf str

is_integer: bool

Boolean(bool)

Native DB_TYPE_BOOLEAN.

IntervalDS

Fields

days: i32

hours: i32

minutes: i32

seconds: i32

fseconds: i32

IntervalYM

Fields

years: i32

months: i32

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

Owned(&'buf QueryValue)

Fallback for the cold / non-borrowable variants (Cursor / Object / Lob / Vector / Json, UTF-16 NCHAR text, synthesized ROWID, BinaryDouble). Boxed so the borrowed enum stays small. This is the rare path.

Implementations

impl QueryValueRef<'_>

pub fn to_owned_value(&self) -> QueryValue

Materialize an owned QueryValue from this borrowed reference, allocating exactly as the owned decode path would. Use this when a borrowed row must outlive the batch buffer (e.g. crossing the Python boundary), or to compare borrowed and owned paths in tests.

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

Borrow this value as decoded text when it is a borrowed Text, otherwise None. Mirror of QueryValue::as_text for the borrowed path.

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

Borrow the canonical decimal text of a NUMBER value, otherwise None. Mirror of QueryValue::as_number_text for the borrowed path. The hot case borrows the per-row number arena (zero copy). The Owned fallback only yields a borrow when the inline form spilled to boxed text; the inline numeric form has no stored &str (it never reaches Owned from the fetch path — NUMBERs are arena-resident).

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

Borrow the bytes of a RAW value, otherwise None. Mirror of QueryValue::as_raw for the borrowed path.

Trait Implementations

impl<'buf> Clone for QueryValueRef<'buf>

fn clone(&self) -> QueryValueRef<'buf>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'buf> Copy for QueryValueRef<'buf>

impl<'buf> Debug for QueryValueRef<'buf>

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

Formats the value using the given formatter.

impl<'buf> PartialEq for QueryValueRef<'buf>

fn eq(&self, other: &QueryValueRef<'buf>) -> 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<'buf> StructuralPartialEq for QueryValueRef<'buf>