Edit D:\app\Administrator\product\11.2.0\dbhome_1\perl\html\lib\Pod\Escapes.html
<?xml version="1.0" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences</title> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <link rev="made" href="mailto:" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences</span></strong></big> </td></tr> </table> <!-- INDEX BEGIN --> <div name="index"> <p><a name="__index__"></a></p> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#goodies">GOODIES</a></li> <li><a href="#caveats">CAVEATS</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#copyright_and_disclaimers">COPYRIGHT AND DISCLAIMERS</a></li> <li><a href="#author">AUTHOR</a></li> </ul> <hr name="index" /> </div> <!-- INDEX END --> <p> </p> <h1><a name="name">NAME</a></h1> <p>Pod::Escapes -- for resolving Pod E<...> sequences</p> <p> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <pre> use Pod::Escapes qw(e2char); ...la la la, parsing POD, la la la... $text = e2char($e_node->label); unless(defined $text) { print "Unknown E sequence \"", $e_node->label, "\"!"; } ...else print/interpolate $text...</pre> <p> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>This module provides things that are useful in decoding Pod E<...> sequences. Presumably, it should be used only by Pod parsers and/or formatters.</p> <p>By default, Pod::Escapes exports none of its symbols. But you can request any of them to be exported. Either request them individually, as with <code>use Pod::Escapes qw(symbolname symbolname2...);</code>, or you can do <code>use Pod::Escapes qw(:ALL);</code> to get all exportable symbols.</p> <p> </p> <hr /> <h1><a name="goodies">GOODIES</a></h1> <dl> <dt><strong><a name="e2char" class="item">e2char($e_content)</a></strong> <dd> <p>Given a name or number that could appear in a <code>E<name_or_num></code> sequence, this returns the string that it stands for. For example, <a href="#e2char"><code>e2char('sol')</code></a>, <a href="#e2char"><code>e2char('47')</code></a>, <a href="#e2char"><code>e2char('0x2F')</code></a>, and <a href="#e2char"><code>e2char('057')</code></a> all return "/", because <code>E<sol></code>, <code>E<47></code>, <code>E<0x2f></code>, and <code>E<057></code>, all mean "/". If the name has no known value (as with a name of "qacute") or is syntactally invalid (as with a name of "1/4"), this returns undef.</p> </dd> </li> <dt><strong><a name="e2charnum" class="item">e2charnum($e_content)</a></strong> <dd> <p>Given a name or number that could appear in a <code>E<name_or_num></code> sequence, this returns the number of the Unicode character that this stands for. For example, <a href="#e2char"><code>e2char('sol')</code></a>, <a href="#e2char"><code>e2char('47')</code></a>, <a href="#e2char"><code>e2char('0x2F')</code></a>, and <a href="#e2char"><code>e2char('057')</code></a> all return 47, because <code>E<sol></code>, <code>E<47></code>, <code>E<0x2f></code>, and <code>E<057></code>, all mean "/", whose Unicode number is 47. If the name has no known value (as with a name of "qacute") or is syntactally invalid (as with a name of "1/4"), this returns undef.</p> </dd> </li> <dt><strong><a name="_name2character_name_" class="item">$Name2character{<em>name</em>}</a></strong> <dd> <p>Maps from names (as in <code>E<name></code>) like "eacute" or "sol" to the string that each stands for. Note that this does not include numerics (like "64" or "x981c"). Under old Perl versions (before 5.7) you get a "?" in place of characters whose Unicode value is over 255.</p> </dd> </li> <dt><strong><a name="_name2character_number_name_" class="item">$Name2character_number{<em>name</em>}</a></strong> <dd> <p>Maps from names (as in <code>E<name></code>) like "eacute" or "sol" to the Unicode value that each stands for. For example, <code>$Name2character_number{'eacute'}</code> is 201, and <code>$Name2character_number{'eacute'}</code> is 8364. You get the correct Unicode value, regardless of the version of Perl you're using -- which differs from <code>%Name2character</code>'s behavior under pre-5.7 Perls.</p> </dd> <dd> <p>Note that this hash does not include numerics (like "64" or "x981c").</p> </dd> </li> <dt><strong><a name="_latin1code_to_fallback_integer_" class="item">$Latin1Code_to_fallback{<em>integer</em>}</a></strong> <dd> <p>For numbers in the range 160 (0x00A0) to 255 (0x00FF), this maps from the character code for a Latin-1 character (like 233 for lowercase e-acute) to the US-ASCII character that best aproximates it (like "e"). You may find this useful if you are rendering POD in a format that you think deals well only with US-ASCII characters.</p> </dd> </li> <dt><strong><a name="_latin1char_to_fallback_character_" class="item">$Latin1Char_to_fallback{<em>character</em>}</a></strong> <dd> <p>Just as above, but maps from characters (like "\xE9", lowercase e-acute) to characters (like "e").</p> </dd> </li> <dt><strong><a name="_code2usascii_integer_" class="item">$Code2USASCII{<em>integer</em>}</a></strong> <dd> <p>This maps from US-ASCII codes (like 32) to the corresponding character (like space, for 32). Only characters 32 to 126 are defined. This is meant for use by <a href="#e2char"><code>e2char($x)</code></a> when it senses that it's running on a non-ASCII platform (where chr(32) doesn't get you a space -- but $Code2USASCII{32} will). It's documented here just in case you might find it useful.</p> </dd> </li> </dl> <p> </p> <hr /> <h1><a name="caveats">CAVEATS</a></h1> <p>On Perl versions before 5.7, Unicode characters with a value over 255 (like lambda or emdash) can't be conveyed. This module does work under such early Perl versions, but in the place of each such character, you get a "?". Latin-1 characters (characters 160-255) are unaffected.</p> <p>Under EBCDIC platforms, <a href="#e2char"><code>e2char($n)</code></a> may not always be the same as <a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlfunc.html#chr"><code>chr(e2charnum($n))</code></a>, and ditto for <code>$Name2character{$name}</code> and <a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlfunc.html#chr"><code>chr($Name2character_number{$name})</code></a>.</p> <p> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <p><a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlpod.html">perlpod</a></p> <p><a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/pod/perlpodspec.html">perlpodspec</a></p> <p><a href="file://C|\ADE\aime_smenon_perl_090715\perl\html/Text/Unidecode.html">Text::Unidecode</a></p> <p> </p> <hr /> <h1><a name="copyright_and_disclaimers">COPYRIGHT AND DISCLAIMERS</a></h1> <p>Copyright (c) 2001-2004 Sean M. Burke. All rights reserved.</p> <p>This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p> <p>This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.</p> <p>Portions of the data tables in this module are derived from the entity declarations in the W3C XHTML specification.</p> <p>Currently (October 2001), that's these three:</p> <pre> <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent</a> <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent">http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent</a> <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent">http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent</a></pre> <p> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>Sean M. Burke <code>sburke@cpan.org</code></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences</span></strong></big> </td></tr> </table> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de