Enum Error

pub enum Error {
    NoError = 0,
    NoDisplay = 255,
    BackendFailed = 256,
    ParametersError = 257,
    NotYetInitialized = 258,
    InvalidBackend = 259,
    InaccessibleFile = 260,
    EmptyString = 261,
    OutOfMemory = 262,
    InternalError = 263,
    AlreadyInitialized = 264,
}

Error is the main type for handling errors in the crate. It’s direct C equivalent is NvdError (Located at include/nvdialog_types.h, line 53). Errors are converted from the C side into this crate using the From<i32> implementation.

When a function returns this type as an error, you should probably handle it, as NvDialog’s design makes one error persist until fixed.

Example

use nvdialog_rs::DialogBox;
use nvdialog_rs::DialogType;
use nvdialog_rs::Error;

fn main() {
    // notice how we do not call nvdialog_rs::init() ?

    if let Err(e) = DialogBox::new("Title", "Message", DialogType::Simple) {
        // Will print 'Error creating dialog: Library has not been initialized yet'
        eprintln!("Error creating dialog: {}", e.to_string());
    }   
}

Notes

• Stringified explanations of the errors are not done with NvDialog’s nvd_stringify_error() function, but using the thiserror crate instead.
• While you could do this, you shouldn’t manually call Error::from(your_number), because the trait is implemented for internal usage mainly.

Variants

NoError = 0

NoDisplay = 255

BackendFailed = 256

ParametersError = 257

NotYetInitialized = 258

InvalidBackend = 259

InaccessibleFile = 260

EmptyString = 261

OutOfMemory = 262

InternalError = 263

AlreadyInitialized = 264

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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, __formatter: &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<i32> for Error

fn from(value: i32) -> Error

Converts to this type from the input type.

impl Copy for Error