Enum rusqlite::Error

pub enum Error {
    SqliteFailure(Error, Option<String>),
    SqliteSingleThreadedMode,
    FromSqlConversionFailure(usize, Type, Box<Error + Send + Sync>),
    IntegralValueOutOfRange(usize, i64),
    Utf8Error(Utf8Error),
    NulError(NulError),
    InvalidParameterName(String),
    InvalidPath(PathBuf),
    ExecuteReturnedResults,
    QueryReturnedNoRows,
    InvalidColumnIndex(usize),
    InvalidColumnName(String),
    InvalidColumnType(usize, Type),
    StatementChangedRows(usize),
    InvalidFunctionParameterType(usize, Type),
    InvalidFilterParameterType(usize, Type),
    UserFunctionError(Box<Error + Send + Sync>),
    ToSqlConversionFailure(Box<Error + Send + Sync>),
    InvalidQuery,
    ModuleError(String),
}

Enum listing possible errors from rusqlite.

Variants

SqliteFailure(Error, Option<String>)

An error from an underlying SQLite call.

SqliteSingleThreadedMode

Error reported when attempting to open a connection when SQLite was configured to allow single-threaded use only.

FromSqlConversionFailure(usize, Type, Box<Error + Send + Sync>)

Error when the value of a particular column is requested, but it cannot be converted to the requested Rust type.

IntegralValueOutOfRange(usize, i64)

Error when SQLite gives us an integral value outside the range of the requested type (e.g., trying to get the value 1000 into a u8). The associated usize is the column index, and the associated i64 is the value returned by SQLite.

Utf8Error(Utf8Error)

Error converting a string to UTF-8.

NulError(NulError)

Error converting a string to a C-compatible string because it contained an embedded nul.

InvalidParameterName(String)

Error when using SQL named parameters and passing a parameter name not present in the SQL.

InvalidPath(PathBuf)

Error converting a file path to a string.

ExecuteReturnedResults

Error returned when an execute call returns rows.

QueryReturnedNoRows

Error when a query that was expected to return at least one row (e.g., for query_row) did not return any.

InvalidColumnIndex(usize)

Error when the value of a particular column is requested, but the index is out of range for the statement.

InvalidColumnName(String)

Error when the value of a named column is requested, but no column matches the name for the statement.

InvalidColumnType(usize, Type)

Error when the value of a particular column is requested, but the type of the result in that column cannot be converted to the requested Rust type.

StatementChangedRows(usize)

Error when a query that was expected to insert one row did not insert any or insert many.

InvalidFunctionParameterType(usize, Type)

Error returned by functions::Context::get when the function argument cannot be converted to the requested type.

InvalidFilterParameterType(usize, Type)

Error returned by vtab::Values::get when the filter argument cannot be converted to the requested type.

UserFunctionError(Box<Error + Send + Sync>)

An error case available for implementors of custom user functions (e.g., create_scalar_function).

ToSqlConversionFailure(Box<Error + Send + Sync>)

Error available for the implementors of the ToSql trait.

InvalidQuery

Error when the SQL is not a SELECT, is not read-only.

ModuleError(String)

An error case available for implementors of custom modules (e.g., create_module).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Error

Performs the conversion.

impl From<NulError> for Error

fn from(err: NulError) -> Error

Performs the conversion.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn description(&self) -> &str

This method is soft-deprecated.

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

The lower-level cause of this error, if any.