Enum oracle::Error

#[non_exhaustive]
pub enum Error {
    OciError(DbError),
    DpiError(DbError),
    NullValue,
    ParseError(Box<dyn Error + Send + Sync>),
    OutOfRange(String),
    InvalidTypeConversion(String, String),
    InvalidBindIndex(usize),
    InvalidBindName(String),
    InvalidColumnIndex(usize),
    InvalidColumnName(String),
    InvalidAttributeName(String),
    InvalidOperation(String),
    UninitializedBindValue,
    NoDataFound,
    BatchErrors(Vec<DbError>),
    InternalError(String),
}

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.

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.

Implementations

impl Error

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.

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)>

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.