Enum ReadStatError 

#[non_exhaustive]
pub enum ReadStatError {
    CLibrary(ReadStatCError),
    UnknownCError(i32),
    DateOverflow,
    IntConversion(TryFromIntError),
    Arrow(ArrowError),
    Parquet(ParquetError),
    Io(Error),
    PathAbs(Error),
    SerdeJson(Error),
    Rayon(ThreadPoolBuildError),
    NulError(NulError),
    ColumnsNotFound {
        requested: Vec<String>,
        available: Vec<String>,
    },
    Other(String),
}

The main error type for the readstat crate.

Wraps errors from the ReadStat C library, Arrow/Parquet processing, I/O operations, and other subsystems into a single error enum.

This enum is #[non_exhaustive]: new variants may be added in minor releases without a semver-breaking change. Match with a wildcard arm (_ => ...) to remain forward-compatible.

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.

CLibrary(ReadStatCError)

Error from the ReadStat C library.

UnknownCError(i32)

Unrecognized C error code not mapped to ReadStatCError.

DateOverflow

Arithmetic overflow during SAS-to-Unix epoch date/time conversion.

IntConversion(TryFromIntError)

Integer conversion error (e.g. u32 to i32 overflow).

Arrow(ArrowError)

Error from the Arrow library.

Parquet(ParquetError)

Error from the Parquet library.

Io(Error)

I/O error.

PathAbs(Error)

Path resolution error.

SerdeJson(Error)

JSON serialization/deserialization error.

Rayon(ThreadPoolBuildError)

Rayon thread pool build error.

NulError(NulError)

Null byte found in a string intended for C FFI.

ColumnsNotFound

One or more specified column names were not found in the dataset.

Fields

requested: Vec<String>

The column names that were requested but not found.

available: Vec<String>

All available column names in the dataset.

Other(String)

Catch-all error with a custom message.

Trait Implementations

impl Debug for ReadStatError

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

Formats the value using the given formatter.

impl Display for ReadStatError

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

Formats the value using the given formatter.

impl Error for ReadStatError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ArrowError> for ReadStatError

fn from(source: ArrowError) -> Self

Converts to this type from the input type.

impl From<Error> for ReadStatError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ReadStatError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ReadStatError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NulError> for ReadStatError

fn from(source: NulError) -> Self

Converts to this type from the input type.

impl From<ParquetError> for ReadStatError

fn from(source: ParquetError) -> Self

Converts to this type from the input type.

impl From<ThreadPoolBuildError> for ReadStatError

fn from(source: ThreadPoolBuildError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for ReadStatError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.