mingw/html/lib/English.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>English - use nice English names for ugly punctuation variables</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;English - use nice English names for ugly punctuation variables</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#synopsis">SYNOPSIS</a></li>
  24         <li><a href="#description">DESCRIPTION</a></li>
  25         <li><a href="#performance">PERFORMANCE</a></li>
  26 </ul>
  27 <!-- INDEX END -->
  28
  29 <hr />
  30 <p>
  31 </p>
  32 <h1><a name="name">NAME</a></h1>
  33 <p>English - use nice English (or awk) names for ugly punctuation variables</p>
  34 <p>
  35 </p>
  36 <hr />
  37 <h1><a name="synopsis">SYNOPSIS</a></h1>
  38 <pre>
  39     use English qw( -no_match_vars ) ;  # Avoids regex performance penalty
  40     use English;
  41     ...
  42     if ($ERRNO =~ /denied/) { ... }</pre>
  43 <p>
  44 </p>
  45 <hr />
  46 <h1><a name="description">DESCRIPTION</a></h1>
  47 <p>This module provides aliases for the built-in variables whose
  48 names no one seems to like to read.  Variables with side-effects
  49 which get triggered just by accessing them (like $0) will still
  50 be affected.</p>
  51 <p>For those variables that have an <strong>awk</strong> version, both long
  52 and short English alternatives are provided.  For example,
  53 the <a href="file://C|\msysgit\mingw\html/pod/perlvar.html#item___"><code>$/</code></a> variable can be referred to either $RS or
  54 $INPUT_RECORD_SEPARATOR if you are using the English module.</p>
  55 <p>See <a href="file://C|\msysgit\mingw\html/pod/perlvar.html">the perlvar manpage</a> for a complete list of these.</p>
  56 <p>
  57 </p>
  58 <hr />
  59 <h1><a name="performance">PERFORMANCE</a></h1>
  60 <p>This module can provoke sizeable inefficiencies for regular expressions,
  61 due to unfortunate implementation details.  If performance matters in
  62 your application and you don't need $PREMATCH, $MATCH, or $POSTMATCH,
  63 try doing</p>
  64 <pre>
  65    use English qw( -no_match_vars ) ;</pre>
  66 <p>.  <strong>It is especially important to do this in modules to avoid penalizing
  67 all applications which use them.</strong></p>
  68 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  69 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  70 <big><strong><span class="block">&nbsp;English - use nice English names for ugly punctuation variables</span></strong></big>
  71 </td></tr>
  72 </table>
  73
  74 </body>
  75
  76 </html>