Enum rusqlite::Error

[−] Show declaration

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

[−] Expand description

Enum listing possible errors from rusqlite.

Variants

SqliteFailure(Error, Option<String>)

[−] Expand description

An error from an underlying SQLite call.

SqliteSingleThreadedMode

[−] Expand description

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

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

[−] Expand description

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

IntegralValueOutOfRange(usize, i64)

[−] Expand description

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)

[−] Expand description

Error converting a string to UTF-8.

NulError(NulError)

[−] Expand description

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

InvalidParameterName(String)

[−] Expand description

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

InvalidPath(PathBuf)

[−] Expand description

Error converting a file path to a string.

ExecuteReturnedResults

[−] Expand description

Error returned when an execute call returns rows.

QueryReturnedNoRows

[−] Expand description

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

InvalidColumnIndex(usize)

[−] Expand description

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

InvalidColumnName(String)

[−] Expand description

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

InvalidColumnType(usize, String, Type)

[−] Expand description

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)

[−] Expand description

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

ToSqlConversionFailure(Box<dyn Error + Send + Sync>)

[−] Expand description

Error available for the implementors of the ToSql trait.

InvalidQuery

[−] Expand description

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

MultipleStatement

[−] Expand description

Error when the SQL contains multiple statements.

Trait Implementations

impl Debug for Error[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Display for Error[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Error for Error[+]

[+] Show hidden undocumented items

fn description(&self) -> &str[−]

Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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

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

fn backtrace(&self) -> Option<&Backtrace>[−]

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

Returns a stack backtrace, if available, of where this error occurred.

impl From<FromSqlError> for Error[+]

The conversion isn't precise, but it's convenient to have it to allow use of get_raw(…).as_…()? in callbacks that take Error.

[+] Show hidden undocumented items

fn from(err: FromSqlError) -> Error[−]

Performs the conversion.

impl From<NulError> for Error[+]

[+] Show hidden undocumented items

fn from(err: NulError) -> Error[−]

Performs the conversion.

impl From<Utf8Error> for Error[+]

[+] Show hidden undocumented items

fn from(err: Utf8Error) -> Error[−]

Performs the conversion.

impl PartialEq<Error> for Error[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Error) -> bool[−]

This method tests for self and other values to be equal, and is used by ==.

[+] Expand attributes

#[must_use] fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.