Struct SliceCursor 

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

Sequential read cursor over a byte slice.

Tracks a position and provides typed reads that advance it. Used for parsing instruction data and reading account fields sequentially.

Implementations

impl<'a> SliceCursor<'a>

pub const fn new(data: &'a [u8]) -> Self

Create a new cursor at position 0.

pub fn from_instruction( data: &'a [u8], min_len: usize, ) -> Result<Self, ProgramError>

Create a cursor from instruction data, validating minimum length.

pub const fn position(&self) -> usize

Current byte position.

pub const fn remaining(&self) -> usize

Remaining bytes after current position.

pub fn data_from_position(&self) -> &'a [u8]

Reference to remaining data from current position.

pub fn skip(&mut self, n: usize) -> Result<(), ProgramError>

Skip n bytes forward.

pub fn read_u8(&mut self) -> Result<u8, ProgramError>

Read a u8 and advance.

pub fn read_u16(&mut self) -> Result<u16, ProgramError>

Read a little-endian u16 and advance.

pub fn read_u32(&mut self) -> Result<u32, ProgramError>

Read a little-endian u32 and advance.

pub fn read_u64(&mut self) -> Result<u64, ProgramError>

Read a little-endian u64 and advance.

pub fn read_i64(&mut self) -> Result<i64, ProgramError>

Read a little-endian i64 and advance.

pub fn read_bool(&mut self) -> Result<bool, ProgramError>

Read a boolean (0 = false, non-zero = true) and advance.

pub fn read_address(&mut self) -> Result<&'a [u8; 32], ProgramError>

Read a 32-byte address and advance.

pub fn read_bytes(&mut self, len: usize) -> Result<&'a [u8], ProgramError>

Read a fixed-size byte array and advance.