Enum rusqlite::Error [−][src]
#[non_exhaustive]
pub enum Error {
Show 25 variants
SqliteFailure(Error, Option<String>),
SqliteSingleThreadedMode,
FromSqlConversionFailure(usize, Type, Box<dyn Error + Send + Sync + 'static>),
IntegralValueOutOfRange(usize, i64),
Utf8Error(Utf8Error),
NulError(NulError),
InvalidParameterName(String),
InvalidPath(PathBuf),
ExecuteReturnedResults,
QueryReturnedNoRows,
InvalidColumnIndex(usize),
InvalidColumnName(String),
InvalidColumnType(usize, String, Type),
StatementChangedRows(usize),
InvalidFunctionParameterType(usize, Type),
InvalidFilterParameterType(usize, Type),
UserFunctionError(Box<dyn Error + Send + Sync + 'static>),
ToSqlConversionFailure(Box<dyn Error + Send + Sync + 'static>),
InvalidQuery,
ModuleError(String),
UnwindingPanic,
GetAuxWrongType,
MultipleStatement,
InvalidParameterCount(usize, usize),
BlobSizeError,
}
Expand description
Enum listing possible errors from rusqlite.
Variants (Non-exhaustive)
This enum is marked as non-exhaustive
An error from an underlying SQLite call.
Error reported when attempting to open a connection when SQLite was configured to allow single-threaded use only.
Error when the value of a particular column is requested, but it cannot be converted to the requested Rust type.
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.
Tuple Fields of Utf8Error
0: Utf8Error
NulError(NulError)
Error converting a string to a C-compatible string because it contained an embedded nul.
Tuple Fields of NulError
0: NulError
InvalidParameterName(String)
Error when using SQL named parameters and passing a parameter name not present in the SQL.
Tuple Fields of InvalidParameterName
0: String
InvalidPath(PathBuf)
Error converting a file path to a string.
Tuple Fields of InvalidPath
0: PathBuf
Error returned when an execute
call
returns rows.
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.
Tuple Fields of InvalidColumnIndex
0: usize
InvalidColumnName(String)
Error when the value of a named column is requested, but no column matches the name for the statement.
Tuple Fields of InvalidColumnName
0: String
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.
Tuple Fields of StatementChangedRows
0: usize
functions
only.Error returned by
functions::Context::get
when the
function argument cannot be converted to the requested type.
vtab
only.Error returned by vtab::Values::get
when
the filter argument cannot be converted to the requested type.
functions
only.An error case available for implementors of custom user functions (e.g.,
create_scalar_function
).
Error available for the implementors of the
ToSql
trait.
Error when the SQL is not a SELECT
, is not read-only.
ModuleError(String)
vtab
only.An error case available for implementors of custom modules (e.g.,
create_module
).
Tuple Fields of ModuleError
0: String
functions
only.An unwinding panic occurs in an UDF (user-defined function).
functions
only.An error returned when
Context::get_aux
attempts to
retrieve data of a different type than what had been stored using
Context::set_aux
.
Error when the SQL contains multiple statements.
Error when the number of bound parameters does not match the number of
parameters in the query. The first usize
is how many parameters were
given, the 2nd is how many were expected.
blob
only.Returned from various functions in the Blob IO positional API. For
example,
Blob::raw_read_at_exact
will
return it if the blob has insufficient data.
Trait Implementations
The conversion isn’t precise, but it’s convenient to have it
to allow use of get_raw(…).as_…()?
in callbacks that take Error
.
Performs the conversion.