Struct ArrayBytesOptional 

pub struct ArrayBytesOptional<'a> { /* private fields */ }

Optional array bytes composed of data and a validity mask.

The mask is 1 byte per element where 0 = invalid/missing, non-zero = valid/present. The mask length is validated at construction to ensure it matches the number of elements.

Equality Semantics

Two ArrayBytesOptional values are considered equal if:

• Their masks are equal
• Their valid (non-null) elements are equal

Invalid (null) element bytes are not compared, since they may differ after round-trip encoding/decoding (e.g., fill value vs original bytes).

Implementations

impl<'a> ArrayBytesOptional<'a>

pub fn new( data: impl Into<Box<ArrayBytes<'a>>>, mask: impl Into<Cow<'a, [u8]>>, ) -> ArrayBytesOptional<'a>

Create a new ArrayBytesOptional with validation.

pub fn data(&self) -> &ArrayBytes<'a>

Get the underlying data.

pub fn mask(&self) -> &Cow<'a, [u8]>

Get the validity mask.

pub fn num_elements(&self) -> usize

Get the number of elements.

pub fn into_parts(self) -> (Box<ArrayBytes<'a>>, Cow<'a, [u8]>)

Consume self and return the data and mask.

pub fn into_owned(self) -> ArrayBytesOptional<'static>

Convert into owned ArrayBytesOptional<'static>.

Trait Implementations

impl<'a> Clone for ArrayBytesOptional<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ArrayBytesOptional<'a>

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

Formats the value using the given formatter.

impl<'a> From<ArrayBytesOptional<'a>> for ArrayBytes<'a>

fn from(value: ArrayBytesOptional<'a>) -> ArrayBytes<'a>

Converts to this type from the input type.

impl PartialEq for ArrayBytesOptional<'_>

fn eq(&self, other: &ArrayBytesOptional<'_>) -> 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 Eq for ArrayBytesOptional<'_>