Struct ReadStatParser 

pub(crate) struct ReadStatParser {
    parser: *mut readstat_parser_t,
}

Safe RAII wrapper around the ReadStat C parser (readstat_parser_t).

Provides a builder-pattern API for configuring callbacks, row limits/offsets, and invoking the parse. The underlying C parser is freed on drop.

Fields

parser: *mut readstat_parser_t

Implementations

impl ReadStatParser

pub(crate) fn new() -> Self

Allocates and initializes a new ReadStat C parser.

pub(crate) fn set_metadata_handler( self, metadata_handler: readstat_metadata_handler, ) -> Result<Self, ReadStatError>

Registers the callback invoked when file-level metadata is parsed.

pub(crate) fn set_row_limit( self, row_limit: Option<u32>, ) -> Result<Self, ReadStatError>

Sets the maximum number of rows to read. None means no limit.

pub(crate) fn set_row_offset( self, row_offset: Option<u32>, ) -> Result<Self, ReadStatError>

Sets the starting row offset for reading. None means start from row 0.

pub(crate) fn set_variable_handler( self, variable_handler: readstat_variable_handler, ) -> Result<Self, ReadStatError>

Registers the callback invoked for each variable (column) definition.

pub(crate) fn set_value_handler( self, value_handler: readstat_value_handler, ) -> Result<Self, ReadStatError>

Registers the callback invoked for each cell value during row parsing.

pub(crate) fn set_open_handler( self, open_handler: readstat_open_handler, ) -> Result<Self, ReadStatError>

Registers a custom handler for opening the data source.

pub(crate) fn set_close_handler( self, close_handler: readstat_close_handler, ) -> Result<Self, ReadStatError>

Registers a custom handler for closing the data source.

pub(crate) fn set_seek_handler( self, seek_handler: readstat_seek_handler, ) -> Result<Self, ReadStatError>

Registers a custom handler for seeking within the data source.

pub(crate) fn set_read_handler( self, read_handler: readstat_read_handler, ) -> Result<Self, ReadStatError>

Registers a custom handler for reading from the data source.

pub(crate) fn set_update_handler( self, update_handler: readstat_update_handler, ) -> Result<Self, ReadStatError>

Registers a custom handler for progress updates.

pub(crate) fn set_io_ctx( self, io_ctx: *mut c_void, ) -> Result<Self, ReadStatError>

Sets a custom I/O context pointer passed to all I/O handler callbacks.

pub(crate) fn parse_sas7bdat( &mut self, path: *const c_char, user_ctx: *mut c_void, ) -> readstat_error_t

Parses a .sas7bdat file, invoking registered callbacks as data is read.

Returns the raw ReadStat error code. Use check_c_error to convert to a Result.

Trait Implementations

impl Drop for ReadStatParser

fn drop(&mut self)

Executes the destructor for this type.