NAME<\/a> XML::LibXML::Error \u2212 Structured Errors<\/p>\n eval { … }; The XML::LibXML::Error class is a tiny frontend to libxml2<\/i>\u2019s structured error support. If XML::LibXML is compiled with structured error support, all errors reported by libxml2 are transformed to XML::LibXML::Error objects. These objects automatically serialize to the corresponding error messages when printed or used in a string operation, but as objects, can also be used to get a detailed and structured information about the error that occurred.<\/p>\n Unlike most other XML::LibXML objects, XML::LibXML::Error doesn\u2019t wrap an underlying libxml2<\/i> structure directly, but rather transforms it to a blessed Perl hash reference containing the individual fields of the structured error information as hash key-value pairs. Individual items (fields) of a structured error can either be obtained directly as $@\u2212>{field}, or using autoloaded methods such as $@\u2212>field()<\/b> (where field is the field name). XML::LibXML::Error objects have the following fields: domain, code, level, file, line, nodename, message, str1, str2, str3, num1, num2, and _prev (some of them may be undefined). $XML::LibXML::Error::WARNINGS=1;<\/p>\n Traditionally, XML::LibXML was suppressing parser warnings by setting libxml2\u2019s global variable xmlGetWarningsDefaultValue to 0. Since 1.70 we do not change libxml2\u2019s global variables anymore; for backward compatibility, XML::LibXML suppresses warnings. This variable can be set to 1 to enable reporting of these warnings via Perl “warn” and to 2 to report hem via “die”.<\/p>\n as_string<\/p>\n $message = $@\u2212>as_string();<\/p>\n This function serializes an XML::LibXML::Error object to a string containing the full error message close to the message produced by libxml2<\/i> default error handlers and tools like xmllint. This method is also used to overload “” operator on XML::LibXML::Error, so it is automatically called whenever XML::LibXML::Error object is treated as a string (e.g. in print $@).<\/p>\n dump<\/p>\n print $@\u2212>dump();<\/p>\n This function serializes an XML::LibXML::Error to a string displaying all fields of the error structure individually on separate lines of the form \u2019name\u2019 => \u2019value\u2019.<\/p>\n domain<\/p>\n $error_domain = $@\u2212>domain();<\/p>\n Returns string containing information about what part of the library raised the error. Can be one of: “parser”, “tree”, “namespace”, “validity”, ” HTML<\/small> parser”, “memory”, “output”, “I\/O”, “ftp”, “http”, “XInclude”, “XPath”, “xpointer”, “regexp”, “Schemas datatype”, “Schemas parser”, “Schemas validity”, “Relax-NG parser”, “Relax-NG validity”, “Catalog”, “C14N”, ” XSLT”,<\/small> “validity”.<\/p>\n code<\/p>\n $error_code = $@\u2212>code();<\/p>\n Returns the actual libxml2 error code. The XML::LibXML::ErrNo module defines constants for individual error codes. Currently libxml2 uses over 480 different error codes.<\/p>\n message<\/p>\n $error_message = $@\u2212>message();<\/p>\n Returns a human-readable informative error message.<\/p>\n level<\/p>\n $error_level = $@\u2212>level();<\/p>\n Returns an integer value describing how consequent is the error. XML::LibXML::Error defines the following constants:<\/p>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
AUTHORS<\/a>
VERSION<\/a>
COPYRIGHT<\/a>
LICENSE<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
if (ref($@)) {
# handle a structured error (XML::LibXML::Error object)
} elsif ($@) {
# error, but not an XML::LibXML::Error object
} else {
# no error
}
$XML::LibXML::Error::WARNINGS=1;
$message = $@\u2212>as_string();
print $@\u2212>dump();
$error_domain = $@\u2212>domain();
$error_code = $@\u2212>code();
$error_message = $@\u2212>message();
$error_level = $@\u2212>level();
$filename = $@\u2212>file();
$line = $@\u2212>line();
$nodename = $@\u2212>nodename();
$error_str1 = $@\u2212>str1();
$error_str2 = $@\u2212>str2();
$error_str3 = $@\u2212>str3();
$error_num1 = $@\u2212>num1();
$error_num2 = $@\u2212>num2();
$string = $@\u2212>context();
$offset = $@\u2212>column();
$previous_error = $@\u2212>_prev();<\/p>\nDESCRIPTION <\/a> <\/h2>\n
$XML::LibXML::Error::WARNINGS<\/p>\n