NAME
Net::Fritz::Error - wraps any error from the Net::Fritz modules
SYNOPSIS
$root_device = Net::Fritz::Box->new->discover;
$root_device->errorcheck;or
$root_device = Net::Fritz::Box->new->discover;
if ($root_device->error) {
die "error: " . $root_device->error;
}DESCRIPTION
Whenever any of the Net::Fritz modules detects an error, it returns an Net::Fritz::Error object. All valid (non-error) objects also implement error and errorcheck via the role Net::Fritz::IsNoError, so calling both methods always works for any Net::Fritz object.
If you want your code to just die() on any error, call $obj-errorcheck> on every returned object (see first example above).
If you just want to check for an error and handle it by yourself, call $obj->error. All non-errors will return 0 (see second example above).
You don't have to check for errors at all, but then you might run into problems when you want to invoke methods on an Net::Fritz::Error object that don't exist (because you expected to get eg. an Net::Fritz::Service object instead).
ATTRIBUTES (read-only)
error
Contains the error message as a string. Don't set this to anything resembling false or you will trick your tests.
METHODS
new
Creates a new Net::Fritz::Error object. You propably don't have to call this method, it's mostly used internally. Expects parameters in key => value form with the following keys:
- error
-
set the error message
With only one parameter (in fact: any odd value of parameters), the first parameter is automatically mapped to error.
errorcheck
Immediately die(), printing the error text.
dump
Returns some preformatted information about the object. Useful for debugging purposes, printing or logging.
COPYRIGHT
Copyright (C) 2015 by Christian Garbs <mitch@cgarbs.de>
LICENSE
Licensed under GNU GPL v2 or later, see <http://www.gnu.org/licenses/gpl-2.0-standalone.html>
AUTHOR
Christian Garbs <mitch@cgarbs.de>
SEE ALSO
See Net::Fritz for general information about this package, especially "INTERFACE" in Net::Fritz for links to the other classes.