Module error

Error types for the Senzing Rust SDK

This module defines a comprehensive error hierarchy that mirrors the Senzing C# SDK exception hierarchy while leveraging Rust’s Result<T, E> types.

The error system provides detailed error information from the underlying Senzing C library with proper error chains and backtrace support. When errors occur, the SDK automatically calls the appropriate getLastException function to retrieve detailed error messages from the native library.

Error Categories

• SzError::Configuration - Configuration and setup errors
• SzError::BadInput - Invalid input parameters or data
• SzError::Database - Database connection or operation errors
• SzError::NotFound - Resource or entity not found
• SzError::Retryable - Temporary errors that can be retried
• SzError::Unrecoverable - Fatal errors requiring reinitialization
• SzError::License - Licensing issues
• SzError::NotInitialized - System not initialized errors
• SzError::DatabaseConnectionLost - Database connectivity lost
• SzError::DatabaseTransient - Temporary database issues
• SzError::ReplaceConflict - Data replacement conflicts
• SzError::RetryTimeoutExceeded - Retry timeout exceeded
• SzError::Unhandled - Unhandled errors
• SzError::UnknownDataSource - Unknown data source errors
• SzError::Unknown - Unexpected or unclassified errors

Examples

use sz_rust_sdk::error::{SzError, SzResult};

fn example_function() -> SzResult<String> {
    // This would normally come from a Senzing operation
    Err(SzError::configuration("Database not initialized"))
}

match example_function() {
    Ok(result) => println!("Success: {}", result),
    Err(SzError::Configuration { message, .. }) => {
        eprintln!("Configuration error: {}", message);
    }
    Err(e) => eprintln!("Other error: {}", e),
}

Enums

SzComponent

Senzing SDK component for error reporting

SzError

Base error type for all Senzing SDK operations

Functions

c_str_to_sz_error 🔒 ^⚠

Utility function to convert C string errors to SzError (Internal)

Type Aliases

SzResult

Result type alias for Senzing SDK operations