Returns a sub-set of all existing message reason labels, based on the
content $reasons string. The following rules apply:
REASONS = BLOCK [ , BLOCKS]
BLOCK = - TO | FROM - TO | ONE | SOURCE
FROM,TO,ONE = TRACE | ASSERT | ,,, | PANIC
SOURCE = USER | PROGRAM | SYSTEM | ALL
The SOURCE specification group all reasons which are usually related to the problem: report about problems caused by the user, reported by the program, or with system interaction.
example: of expended REASONS
|<B>is_fatalB>($reason)||Returns true if the $reason is severe enough to cause an exception (or program termination).|
|<B>is_reasonB>($name)||Returns true if the STRING is one of the predefined REASONS.|
Run-modes are explained in Log::Report::Dispatcher.
<B>mode_acceptsB>($mode) Returns something acceptable by expand_reasons() <B>mode_numberB>($name|$mode) Returns the $mode as number. <B>must_show_locationB>($mode, $reason) <B>must_show_stackB>($mode, $reason)
<B>escape_charsB>(STRING) Replace all escape characters into their readable counterpart. For instance, a new-line is replaced by backslash-n. <B>parse_localeB>(STRING) Decompose a locale string.
For simplicity of the callers code, the capatization of the returned fields is standardized to the preferred, although the match is case- insensitive as required by the RFC. The territory in returned in capitals (ISO3166), the language is lower-case (ISO639), the script as upper-case first, the character-set as lower-case, and the modifier and variant unchanged.
In LIST context, four elements are returned: language, territory, character-set (codeset), and modifier. Those four are important for the usual unix translationg infrastructure. Only the country is obligatory, the others can be undef. It may also return C and POSIX.
In SCALAR context, a HASH is returned which can contain more information: language, script, territory, variant, codeset, and modifiers. The variant (RFC3066 is probably never used)
<B>pkg2domainB>( $package, [$domain, $filename, $line] ) With $domain, $filename and $line, this registers a location where the textdomain is specified. Each $package can only belong to one $domain.
Without these parameters, the registered domain for the $package is returned.
<B>to_htmlB>($string) [1.02] Escape HTML volatile characters. <B>unescape_charsB>(STRING) Replace all backslash-something escapes by their escape character. For instance, backslash-t is replaced by a tab character.
my ($language, $territory, $charset, $modifier) = parse_locale nl_BE.utf-8@home; my @take = expand_reasons INFO-ERROR,PANIC;
This module is part of Log-Report-Optional distribution version 1.02, built on January 18, 2016. Website: http://perl.overmeer.net/log-report/
Copyrights 2013-2016 by [Mark Overmeer]. For other contributors see ChangeLog.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html
|perl v5.20.3||LOG::REPORT::UTIL (3)||2016-01-18|