details¶

    \%details = $error->details;

Get the error details.

errno¶

Get the value of "errno" when the exception was created.

previous¶

Get the value of $@ (i.e. latest exception) at the time the exception was created.

trace¶

Get a stack trace indicating where in the code the exception was created.

type¶

Get the exception type, if any.

new¶

    $error = File::KDBX::Error->new($message, %details);

Construct a new error.

error¶

    $error = error($error);
    $error = error($message, %details);
    $error = File::KDBX::Error->error($error);
    $error = File::KDBX::Error->error($message, %details);

Wrap a thing to make it an error object. If the thing is already an error, it gets returned. Otherwise what is passed will be forwarded to "new" to create a new error object.

This can be convenient for error handling when you're not sure what the exception is but you want to treat it as a File::KDBX::Error. Example:

    eval { ... };
    if (my $error = error(@_)) {
        if ($error->type eq 'key.missing') {
            handle_missing_key($error);
        }
        else {
            handle_other_error($error);
        }
    }

to_string¶

    $message = $error->to_string;
    $message = "$error";

Stringify an error.

This does not contain a stack trace, but you can set the "DEBUG" environment variable to at least 2 to stringify the whole error object.

throw¶

    File::KDBX::Error::throw($message, %details);
    $error->throw;

Throw an error.

warn¶

    File::KDBX::Error::warn($message, %details);
    $error->warn;

Log a warning.

alert¶

    alert $error;

Importable alias for "warn".