Enum diesel::result::Error

source ·
#[non_exhaustive]
pub enum Error { InvalidCString(NulError), DatabaseError(DatabaseErrorKind, Box<dyn DatabaseErrorInformation + Send + Sync>), NotFound, QueryBuilderError(Box<dyn StdError + Send + Sync>), DeserializationError(Box<dyn StdError + Send + Sync>), SerializationError(Box<dyn StdError + Send + Sync>), RollbackErrorOnCommit { rollback_error: Box<Error>, commit_error: Box<Error>, }, RollbackTransaction, AlreadyInTransaction, NotInTransaction, BrokenTransactionManager, }
Expand description

Represents all the ways that a query can fail.

This type is not intended to be exhaustively matched, and new variants may be added in the future without a major version bump.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

InvalidCString(NulError)

The query contained a nul byte.

This should never occur in normal usage.

§

DatabaseError(DatabaseErrorKind, Box<dyn DatabaseErrorInformation + Send + Sync>)

The database returned an error.

While Diesel prevents almost all sources of runtime errors at compile time, it does not attempt to prevent 100% of them. Typically this error will occur from insert or update statements due to a constraint violation.

§

NotFound

No rows were returned by a query expected to return at least one row.

This variant is only returned by get_result and first. load does not treat 0 rows as an error. If you would like to allow either 0 or 1 rows, call optional on the result.

§

QueryBuilderError(Box<dyn StdError + Send + Sync>)

The query could not be constructed

An example of when this error could occur is if you are attempting to construct an update statement with no changes (e.g. all fields on the struct are None).

§

DeserializationError(Box<dyn StdError + Send + Sync>)

An error occurred deserializing the data being sent to the database.

Typically this error means that the stated type of the query is incorrect. An example of when this error might occur in normal usage is attempting to deserialize an infinite date into chrono.

§

SerializationError(Box<dyn StdError + Send + Sync>)

An error occurred serializing the data being sent to the database.

An example of when this error would be returned is if you attempted to serialize a chrono::NaiveDate earlier than the earliest date supported by PostgreSQL.

§

RollbackErrorOnCommit

An error occurred when attempting rollback of a transaction subsequently to a failed commit attempt.

When a commit attempt fails and Diesel believes that it can attempt a rollback to return the connection back in a usable state (out of that transaction), it attempts it then returns the original error.

If that fails, you get this.

Fields

§rollback_error: Box<Error>

The error that was encountered when attempting the rollback

§commit_error: Box<Error>

The error that was encountered during the failed commit attempt

§

RollbackTransaction

Roll back the current transaction.

You can return this variant inside of a transaction when you want to roll it back, but have no actual error to return. Diesel will never return this variant unless you gave it to us, and it can be safely ignored in error handling.

§

AlreadyInTransaction

Attempted to perform an operation that cannot be done inside a transaction when a transaction was already open.

§

NotInTransaction

Attempted to perform an operation that can only be done inside a transaction when no transaction was open

§

BrokenTransactionManager

Transaction manager broken, likely due to a broken connection. No other operations are possible.

Trait Implementations§

source§

impl Debug for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for Error

source§

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

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

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

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

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

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. Read more
source§

impl From<NulError> for Error

source§

fn from(e: NulError) -> Self

Converts to this type from the input type.
source§

impl PartialEq for Error

source§

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

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

Auto Trait Implementations§

§

impl Freeze for Error

§

impl !RefUnwindSafe for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl !UnwindSafe for Error

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoSql for T

source§

fn into_sql<T>(self) -> AsExprOf<Self, T>

Convert self to an expression for Diesel’s query builder. Read more
source§

fn as_sql<'a, T>(&'a self) -> AsExprOf<&'a Self, T>

Convert &self to an expression for Diesel’s query builder. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> ErasedDestructor for T
where T: 'static,

source§

impl<T> MaybeSendSync for T