Enum Error

#[non_exhaustive]
pub enum Error {
    OciError(DbError),
    DpiError(DbError),
    NullValue,
    ParseError(Box<dyn Error + Send + Sync>),
    OutOfRange(String),
    InvalidTypeConversion(String, String),
    InvalidArgument {
        message: Cow<'static, str>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    InvalidBindIndex(usize),
    InvalidBindName(String),
    InvalidColumnIndex(usize),
    InvalidColumnName(String),
    InvalidAttributeName(String),
    InvalidOperation(String),
    UninitializedBindValue,
    NoDataFound,
    BatchErrors(Vec<DbError>),
    InternalError(String),
    Other {
        kind: ErrorKind,
        message: Cow<'static, str>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

The error type for oracle

Note: This enum will be changed to struct in the future.

Variants (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.

OciError(DbError)

👎Deprecated: Use kind() to check the error category. Use db_error() to get DbError.

Error from an underlying Oracle client library.

DpiError(DbError)

👎Deprecated: Use kind() to check the error category. Use db_error() to get DbError.

Error from an underlying ODPI-C layer.

NullValue

👎Deprecated: Use kind() to check the error category.

Error when NULL value is got but the target rust type cannot handle NULL. Use Option<...> in this case.

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

👎Deprecated: Use kind() to check the error category. Use source() to get the underlying error.

Error when conversion from a string to an Oracle value fails

OutOfRange(String)

👎Deprecated: Use kind() to check the error category. Use to_string() to get the message.

Error when conversion from a type to another fails due to out-of-range

InvalidTypeConversion(String, String)

👎Deprecated: Use kind() to check the error category.

Error when conversion from a type to another is not allowed.

InvalidArgument

👎Deprecated

Error when an unacceptable argument is passed

Fields

message: Cow<'static, str>

👎Deprecated

source: Option<Box<dyn Error + Send + Sync>>

👎Deprecated

InvalidBindIndex(usize)

👎Deprecated: Use kind() to check the error category.

Error when the bind parameter index is out of range. (one based)

InvalidBindName(String)

👎Deprecated: Use kind() to check the error category.

Error when the bind parameter name is not in the SQL.

InvalidColumnIndex(usize)

👎Deprecated: Use kind() to check the error category.

Error when the column index is out of range. (zero based)

InvalidColumnName(String)

👎Deprecated: Use kind() to check the error category.

Error when the column name is not in the SQL.

InvalidAttributeName(String)

👎Deprecated: Use kind() to check the error category.

Error when the specified attribute name is not found.

InvalidOperation(String)

👎Deprecated: Use kind() to check the error category. Use to_string() to get the message.

Error when invalid method is called such as calling execute for select statements.

UninitializedBindValue

👎Deprecated: Use kind() to check the error category.

Error when an uninitialized bind value is accessed. Bind values must be initialized by Statement::bind, Statement::execute or Connection::execute in advance.

NoDataFound

👎Deprecated: Use kind() to check the error category.

Error when no more rows exist in the SQL.

BatchErrors(Vec<DbError>)

👎Deprecated: Use kind() to check the error category. Use batch_errors() to get the db errors.

InternalError(String)

👎Deprecated: Use kind() to check the error category. Use to_string() to get the message.

Internal error. When you get this error, please report it with a test case to reproduce it.

Other

Other or newly added error

Don’t use this variant directly.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

kind: ErrorKind

message: Cow<'static, str>

source: Option<Box<dyn Error + Send + Sync>>

Implementations

impl Error

pub fn new<M>(kind: ErrorKind, message: M) -> Error

where M: Into<Cow<'static, str>>,

Create a new error.

pub fn add_source<E>(self, source: E) -> Error

where E: Into<Box<dyn Error + Send + Sync>>,

Add the lower-level error used as the return value of Error::source().

Note: This is intended to be applied to the Error created by Error::new(). Otherwise, source may be ignored.

pub fn with_source<E>(kind: ErrorKind, source: E) -> Error

where E: Into<Box<dyn Error + Send + Sync>>,

Create a new error from an arbitrary error

The error message of this error is same with that of the source specified.

This is a shortcut for Error::new(kind, "").add_source(source).

pub fn kind(&self) -> ErrorKind

Returns the corresponding ErrorKind for this error.

pub fn db_error(&self) -> Option<&DbError>

Returns DbError.

pub fn batch_errors(&self) -> Option<&Vec<DbError>>

Returns batch errors. See “Error Handling with batch errors”

pub fn oci_code(&self) -> Option<i32>

Returns Oracle error code. For example 1 for “ORA-0001: unique constraint violated”

pub fn dpi_code(&self) -> Option<i32>

Returns ODPI-C error code.

pub fn into_source(self) -> Option<Box<dyn Error + Send + Sync>>

Consumes the Error, returning its inner error (if any).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

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

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

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

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.

impl From<ParseFloatError> for Error

fn from(err: ParseFloatError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for Error

fn from(err: ParseIntError) -> Self

Converts to this type from the input type.

impl From<ParseOracleTypeError> for Error

fn from(err: ParseOracleTypeError) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<T>> for Error

fn from(err: PoisonError<T>) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for Error

fn from(err: TryFromIntError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Self

Converts to this type from the input type.