Enum SqlResult

pub enum SqlResult<T> {
    Success(T),
    SuccessWithInfo(T),
    NoData,
    NeedData,
    StillExecuting,
    Error {
        function: &'static str,
    },
}

Result of an ODBC function call. Variants hold the same meaning as the constants associated with SqlReturn. This type may hold results, but it is still the responsibility of the user to fetch and handle the diagnostics in case of an Error.

Variants

Success(T)

The function has been executed successfully.

SuccessWithInfo(T)

The function has been executed successfully. There have been warnings.

NoData

Meaning depends on the function emitting NoData.

NeedData

Emmitted by execute in case delayed parameters have been bound and their input values are now required.

StillExecuting

The function was started asynchronously and is still executing.

Error

The function returned an error state. Check diagnostics.

Fields

function: &'static str

Name of the ODBC Api call which caused the error. This might help interpreting associated ODBC diagnostics if the error is bubbled all the way up to the end users output, but the context is lost.

Implementations

impl SqlResult<()>

pub fn into_result_bool(self, handle: &impl Diagnostics) -> Result<bool, Error>

Use this instead of Self::into_result if you expect SqlResult::NoData to be a valid value. SqlResult::NoData is mapped to Ok(false), all other success values are Ok(true).

impl<T> SqlResult<T>

pub fn has_diganostics(&self) -> bool

true for Self::SuccessWithInfo and Self::Error. If true one might expect diagnostic records to be present. If false it would indicate their absense.

pub fn into_result(self, handle: &impl Diagnostics) -> Result<T, Error>

Self::Success and Self::SuccessWithInfo are mapped to Ok. In case of Self::SuccessWithInfo any diagnostics are logged. Self::Error is mapped to error. Other states [Self::NoData] and Self::NeedData would lead to a panic. Most ODBC functions are not suppossed to return these status codes.

pub fn into_result_without_logging( self, handle: &impl Diagnostics, ) -> Result<T, Error>

Self::Success and Self::SuccessWithInfo are mapped to Ok. Self::Error is mapped to error. Other states [Self::NoData] and Self::NeedData would lead to a panic. Most ODBC functions are not suppossed to return these status codes.

In case of Self::Error or Self::SuccessWithInfo no logging of diagnostic records is performed by this method. You may want to use Self::into_result` instead.

pub fn or_no_data(self) -> SqlResult<Option<T>>

Maps SqlResult::Success and SqlResult::SuccessWithInfo to Some. Maps SqlResult::NoData to SqlResult::Success with None.

impl SqlResult<()>

pub fn on_success<F, T>(self, f: F) -> SqlResult<T>

where F: FnOnce() -> T,

Append a return value a successful to Result

impl<T> SqlResult<T>

pub fn is_err(&self) -> bool

True if variant is SqlResult::Error.

pub fn map<U, F>(self, f: F) -> SqlResult<U>

where F: FnOnce(T) -> U,

Applies f to any value wrapped in Success or SuccessWithInfo.

pub fn on_no_data<F>(self, f: F) -> SqlResult<T>

where F: FnOnce() -> T,

Maps Self::NoData to Self::Success with the given value. This makes it easy to chain calls of to SqlResult::on_no_data after calls to SqlResult::on_success.

pub fn on_need_data<F>(self, f: F) -> SqlResult<T>

where F: FnOnce() -> T,

Maps Self::NeedData to Self::Success with the given value. This makes it easy to chain calls of to SqlResult::on_need_data after calls to SqlResult::on_success.

pub fn unwrap(self) -> T

Trait Implementations

impl<T: Clone> Clone for SqlResult<T>

fn clone(&self) -> SqlResult<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for SqlResult<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for SqlResult<T>

fn eq(&self, other: &SqlResult<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T: Copy> Copy for SqlResult<T>

impl<T: Eq> Eq for SqlResult<T>

impl<T> StructuralPartialEq for SqlResult<T>