Author image Олег Пронин

NAME

XS::ErrorCode - Perl binding for panda::ErrorCode (nested std::error_code)

SYNOPSIS

    my $err = SomeFramework->some_method();
    if ($err) {
        say $err;
        say $err->value;
        say $err->category->name;
        say $err->message;
    }

DESCRIPTION

This binding is intended for use from XS modules that returns errors as panda::ErrorCode objects to perl. It provides them with typemap and Perl interface.

See XS::STL::ErrorCode for more info about error codes.

API

new($error_code, $next_error_code)

Creates nested error code object from XS::STL::ErrorCode and XS::ErrorCode. Normally you should not create these objects from perl.

value()

Returns top error code value (integer)

category()

Returns top error code category as XS::STL::ErrorCategory object

message()

Returns top error message

code()

Returns top error as XS::STL::ErrorCode object

next()

Returns XS::ErrorCode object with next error as top error or undef if it constains a single error.

Example printing all errors in stack:

    while ($err) {
        say $err->value;
        say $err->message;
        $err = $err->next;
    }

operator bool

Returns true if object contains errors

operator ""

Stringifies to whole stack of errors. Example output:

    Connection timed out (110:generic), preceded by:
    Permission denied (13:generic)

operator ==, eq

Compares with XS::ErrorCode or XS::STL::ErrorCode or number. Only top error is compared.

    my $err = SomeFramework->some_method();
    if ($err == SomeFramework::Error::unauthorized) {
        
    }
    elsif ($err == XS::STL::errc::connection_refused) {
    }

AUTHOR

Pronin Oleg <syber@crazypanda.ru>, Crazy Panda LTD

LICENSE

You may distribute this code under the same terms as Perl itself.