Enum Validity 

#[non_exhaustive]
pub enum Validity<'a> {
    None,
    Bitmap {
        bytes: &'a [u8],
        row_count: usize,
    },
}

Per-row null information.

Validity::None means “no nulls for this column”; the column carries no bitmap on the wire and is_null always returns false.

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.

None

No row in this column is null.

Bitmap

LSB-first bitmap; bit 1 = null. row_count rows total.

Fields

bytes: &'a [u8]

row_count: usize

Implementations

impl<'a> Validity<'a>

pub fn from_bitmap(bytes: &'a [u8], row_count: usize) -> Result<Self>

Construct a bitmap-backed validity view.

Returns Err(InvalidApiCall) if bytes.len() < row_count.div_ceil(8) — a too-short bitmap would otherwise cause Self::is_null to silently report null rows as non-null (the bytes beyond the buffer end are indistinguishable from “this row’s bit is 0”). The decoder always sizes the bitmap exactly to row_count.div_ceil(8) (see decode_validity), so the error is unreachable from crate-internal callers; the check exists so external callers can’t build a corrupt view and have it silently mis-report NULL rows.

pub fn has_nulls(&self) -> bool

pub fn is_null(&self, row: usize) -> bool

true if row is null. Out-of-range rows return false (matches the column accessors’ “row was never written” treatment).

Bounds-checked: a Validity::Bitmap constructed directly (bypassing from_bitmap) with a too-short bitmap reports false for the missing tail rather than panicking. Constructor-validated values never trip the fallback.

pub fn bytes(&self) -> Option<&'a [u8]>

Raw bitmap, when present.

Trait Implementations

impl<'a> Clone for Validity<'a>

fn clone(&self) -> Validity<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Validity<'a>

impl<'a> Debug for Validity<'a>

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

Formats the value using the given formatter.