Enum odbc_api::handles::SqlResult

pub enum SqlResult<T> {
    Success(T),
    SuccessWithInfo(T),
    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.

Error

Fields

function: &'static str

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

Function returned error state. Check diagnostics.

Implementations

impl<T> SqlResult<T>

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.

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

Intended to be used to be used after bulk fetching into a buffer. Mostly the same as Self::into_result, but if error_for_truncation is true any diagnostics are inspected for truncation. If any truncation is found an error is returned.

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 unwrap(self) -> T

Trait Implementations

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

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

Formats the value using the given formatter.