Struct OptionByte 

pub struct OptionByte<T: Copy> { /* private fields */ }

Zero-copy tagged optional. See module docs for the layout and usage contract.

Implementations

impl<T: Copy> OptionByte<T>

pub const fn none(default_value: T) -> Self

Construct a None variant. Because the struct is #[repr(C)] with a Pod value field, the value payload must still be bitwise valid; the caller provides a default value that is ignored by OptionByte::get.

pub const fn some(value: T) -> Self

Construct a Some(value) variant.

pub const fn raw_tag(&self) -> u8

The tag byte as the sender encoded it. Callers should never inspect this directly; use OptionByte::get so the tag is validated first.

pub fn get(&self) -> Result<Option<&T>, ProgramError>

Validate the tag byte and return the appropriate Rust Option.

Returns Err(ProgramError::InvalidInstructionData) when the tag is neither 0 nor 1. Any other byte indicates malformed instruction data and is the exact surface a Quasar OptionZc would flag in validate_zc.

pub fn validate_tag(&self) -> ProgramResult

Validate-only: confirms the tag byte is 0 or 1. Useful for callers who want to reject malformed input early without taking a reference to the payload.

Trait Implementations

impl<T: Clone + Copy> Clone for OptionByte<T>

fn clone(&self) -> OptionByte<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy + Copy> Copy for OptionByte<T>