home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / Numbers / Words / lang.en_US.php < prev    next >
Encoding:
PHP Script  |  2008-07-02  |  17.2 KB  |  516 lines

  1. <?php
  2. /* vim: set expandtab tabstop=4 softtabstop=4 shiftwidth=4: */
  3. //
  4. // +----------------------------------------------------------------------+
  5. // | PHP version 4                                                        |
  6. // +----------------------------------------------------------------------+
  7. // | Copyright (c) 1997-2003 The PHP Group                                |
  8. // +----------------------------------------------------------------------+
  9. // | This source file is subject to version 3.0 of the PHP license,       |
  10. // | that is bundled with this package in the file LICENSE, and is        |
  11. // | available at through the world-wide-web at                           |
  12. // | http://www.php.net/license/3_0.txt.                                  |
  13. // | If you did not receive a copy of the PHP license and are unable to   |
  14. // | obtain it through the world-wide-web, please send a note to          |
  15. // | license@php.net so we can mail you a copy immediately.               |
  16. // +----------------------------------------------------------------------+
  17. // | Authors: Piotr Klaban <makler@man.torun.pl>                          |
  18. // +----------------------------------------------------------------------+
  19. //
  20. // $Id: lang.en_US.php,v 1.5 2005/09/18 19:52:22 makler Exp $
  21. //
  22. // Numbers_Words class extension to spell numbers in American English language.
  23. //
  24.  
  25. /**
  26.  * Class for translating numbers into American English.
  27.  *
  28.  * @author Piotr Klaban
  29.  * @package Numbers_Words
  30.  */
  31.  
  32. /**
  33.  * Include needed files
  34.  */
  35. require_once("Numbers/Words.php");
  36.  
  37. /**
  38.  * Class for translating numbers into American English.
  39.  *
  40.  * @author Piotr Klaban
  41.  * @package Numbers_Words
  42.  */
  43. class Numbers_Words_en_US extends Numbers_Words
  44. {
  45.  
  46.     // {{{ properties
  47.     
  48.     /**
  49.      * Locale name
  50.      * @var string
  51.      * @access public
  52.      */
  53.     var $locale      = 'en_US';
  54.  
  55.     /**
  56.      * Language name in English
  57.      * @var string
  58.      * @access public
  59.      */
  60.     var $lang        = 'American English';
  61.  
  62.     /**
  63.      * Native language name
  64.      * @var string
  65.      * @access public
  66.      */
  67.     var $lang_native = 'American English';
  68.     
  69.     /**
  70.      * The word for the minus sign
  71.      * @var string
  72.      * @access private
  73.      */
  74.     var $_minus = 'minus'; // minus sign
  75.     
  76.     /**
  77.      * The sufixes for exponents (singular and plural)
  78.      * Names partly based on:
  79.      * http://home.earthlink.net/~mrob/pub/math/largenum.html
  80.      * http://mathforum.org/dr.math/faq/faq.large.numbers.html
  81.      * http://www.mazes.com/AmericanNumberingSystem.html
  82.      * @var array
  83.      * @access private
  84.      */
  85.     var $_exponent = array(
  86.         0 => array(''),
  87.         3 => array('thousand'),
  88.         6 => array('million'),
  89.         9 => array('billion'),
  90.        12 => array('trillion'),
  91.        15 => array('quadrillion'),
  92.        18 => array('quintillion'),
  93.        21 => array('sextillion'),
  94.        24 => array('septillion'),
  95.        27 => array('octillion'),
  96.        30 => array('nonillion'),
  97.        33 => array('decillion'),
  98.        36 => array('undecillion'),
  99.        39 => array('duodecillion'),
  100.        42 => array('tredecillion'),
  101.        45 => array('quattuordecillion'),
  102.        48 => array('quindecillion'),
  103.        51 => array('sexdecillion'),
  104.        54 => array('septendecillion'),
  105.        57 => array('octodecillion'),
  106.        60 => array('novemdecillion'),
  107.        63 => array('vigintillion'),
  108.        66 => array('unvigintillion'),
  109.        69 => array('duovigintillion'),
  110.        72 => array('trevigintillion'),
  111.        75 => array('quattuorvigintillion'),
  112.        78 => array('quinvigintillion'),
  113.        81 => array('sexvigintillion'),
  114.        84 => array('septenvigintillion'),
  115.        87 => array('octovigintillion'),
  116.        90 => array('novemvigintillion'),
  117.        93 => array('trigintillion'),
  118.        96 => array('untrigintillion'),
  119.        99 => array('duotrigintillion'),
  120.        // 100 => array('googol') - not latin name
  121.        // 10^googol = 1 googolplex
  122.       102 => array('trestrigintillion'),
  123.       105 => array('quattuortrigintillion'),
  124.       108 => array('quintrigintillion'),
  125.       111 => array('sextrigintillion'),
  126.       114 => array('septentrigintillion'),
  127.       117 => array('octotrigintillion'),
  128.       120 => array('novemtrigintillion'),
  129.       123 => array('quadragintillion'),
  130.       126 => array('unquadragintillion'),
  131.       129 => array('duoquadragintillion'),
  132.       132 => array('trequadragintillion'),
  133.       135 => array('quattuorquadragintillion'),
  134.       138 => array('quinquadragintillion'),
  135.       141 => array('sexquadragintillion'),
  136.       144 => array('septenquadragintillion'),
  137.       147 => array('octoquadragintillion'),
  138.       150 => array('novemquadragintillion'),
  139.       153 => array('quinquagintillion'),
  140.       156 => array('unquinquagintillion'),
  141.       159 => array('duoquinquagintillion'),
  142.       162 => array('trequinquagintillion'),
  143.       165 => array('quattuorquinquagintillion'),
  144.       168 => array('quinquinquagintillion'),
  145.       171 => array('sexquinquagintillion'),
  146.       174 => array('septenquinquagintillion'),
  147.       177 => array('octoquinquagintillion'),
  148.       180 => array('novemquinquagintillion'),
  149.       183 => array('sexagintillion'),
  150.       186 => array('unsexagintillion'),
  151.       189 => array('duosexagintillion'),
  152.       192 => array('tresexagintillion'),
  153.       195 => array('quattuorsexagintillion'),
  154.       198 => array('quinsexagintillion'),
  155.       201 => array('sexsexagintillion'),
  156.       204 => array('septensexagintillion'),
  157.       207 => array('octosexagintillion'),
  158.       210 => array('novemsexagintillion'),
  159.       213 => array('septuagintillion'),
  160.       216 => array('unseptuagintillion'),
  161.       219 => array('duoseptuagintillion'),
  162.       222 => array('treseptuagintillion'),
  163.       225 => array('quattuorseptuagintillion'),
  164.       228 => array('quinseptuagintillion'),
  165.       231 => array('sexseptuagintillion'),
  166.       234 => array('septenseptuagintillion'),
  167.       237 => array('octoseptuagintillion'),
  168.       240 => array('novemseptuagintillion'),
  169.       243 => array('octogintillion'),
  170.       246 => array('unoctogintillion'),
  171.       249 => array('duooctogintillion'),
  172.       252 => array('treoctogintillion'),
  173.       255 => array('quattuoroctogintillion'),
  174.       258 => array('quinoctogintillion'),
  175.       261 => array('sexoctogintillion'),
  176.       264 => array('septoctogintillion'),
  177.       267 => array('octooctogintillion'),
  178.       270 => array('novemoctogintillion'),
  179.       273 => array('nonagintillion'),
  180.       276 => array('unnonagintillion'),
  181.       279 => array('duononagintillion'),
  182.       282 => array('trenonagintillion'),
  183.       285 => array('quattuornonagintillion'),
  184.       288 => array('quinnonagintillion'),
  185.       291 => array('sexnonagintillion'),
  186.       294 => array('septennonagintillion'),
  187.       297 => array('octononagintillion'),
  188.       300 => array('novemnonagintillion'),
  189.       303 => array('centillion'),
  190.       309 => array('duocentillion'),
  191.       312 => array('trecentillion'),
  192.       366 => array('primo-vigesimo-centillion'),
  193.       402 => array('trestrigintacentillion'),
  194.       603 => array('ducentillion'),
  195.       624 => array('septenducentillion'),
  196.      // bug on a earthlink page: 903 => array('trecentillion'),
  197.      2421 => array('sexoctingentillion'),
  198.      3003 => array('millillion'),
  199.      3000003 => array('milli-millillion')
  200.         );
  201.  
  202.     /**
  203.      * The array containing the digits (indexed by the digits themselves).
  204.      * @var array
  205.      * @access private
  206.      */
  207.     var $_digits = array(
  208.         0 => 'zero', 'one', 'two', 'three', 'four',
  209.         'five', 'six', 'seven', 'eight', 'nine'
  210.     );
  211.  
  212.     /**
  213.      * The word separator
  214.      * @var string
  215.      * @access private
  216.      */
  217.     var $_sep = ' ';
  218.  
  219.     /**
  220.      * The currency names (based on the below links,
  221.      * informations from central bank websites and on encyclopedias)
  222.      *
  223.      * @var array
  224.      * @link http://30-03-67.dreamstation.com/currency_alfa.htm World Currency Information
  225.      * @link http://www.jhall.demon.co.uk/currency/by_abbrev.html World currencies
  226.      * @link http://www.shoestring.co.kr/world/p.visa/change.htm Currency names in English
  227.      * @access private
  228.      */
  229.     var $_currency_names = array(
  230.       'ALL' => array(array('lek'), array('qindarka')),
  231.       'AUD' => array(array('Australian dollar'), array('cent')),
  232.       'BAM' => array(array('convertible marka'), array('fenig')),
  233.       'BGN' => array(array('lev'), array('stotinka')),
  234.       'BRL' => array(array('real'), array('centavos')),
  235.       'BYR' => array(array('Belarussian rouble'), array('kopiejka')),
  236.       'CAD' => array(array('Canadian dollar'), array('cent')),
  237.       'CHF' => array(array('Swiss franc'), array('rapp')),
  238.       'CYP' => array(array('Cypriot pound'), array('cent')),
  239.       'CZK' => array(array('Czech koruna'), array('halerz')),
  240.       'DKK' => array(array('Danish krone'), array('ore')),
  241.       'EEK' => array(array('kroon'), array('senti')),
  242.       'EUR' => array(array('euro'), array('euro-cent')),
  243.       'GBP' => array(array('pound', 'pounds'), array('pence', 'pence')),
  244.       'HKD' => array(array('Hong Kong dollar'), array('cent')),
  245.       'HRK' => array(array('Croatian kuna'), array('lipa')),
  246.       'HUF' => array(array('forint'), array('filler')),
  247.       'ILS' => array(array('new sheqel','new sheqels'), array('agora','agorot')),
  248.       'ISK' => array(array('Icelandic kr≤na'), array('aurar')),
  249.       'JPY' => array(array('yen'), array('sen')),
  250.       'LTL' => array(array('litas'), array('cent')),
  251.       'LVL' => array(array('lat'), array('sentim')),
  252.       'MKD' => array(array('Macedonian dinar'), array('deni')),
  253.       'MTL' => array(array('Maltese lira'), array('centym')),
  254.       'NOK' => array(array('Norwegian krone'), array('oere')),
  255.       'PLN' => array(array('zloty', 'zlotys'), array('grosz')),
  256.       'ROL' => array(array('Romanian leu'), array('bani')),
  257.       'RUB' => array(array('Russian Federation rouble'), array('kopiejka')),
  258.       'SEK' => array(array('Swedish krona'), array('oere')),
  259.       'SIT' => array(array('Tolar'), array('stotinia')),
  260.       'SKK' => array(array('Slovak koruna'), array()),
  261.       'TRL' => array(array('lira'), array('kuru■')),
  262.       'UAH' => array(array('hryvna'), array('cent')),
  263.       'USD' => array(array('dollar'), array('cent')),
  264.       'YUM' => array(array('dinars'), array('para')),
  265.       'ZAR' => array(array('rand'), array('cent'))
  266.     );
  267.  
  268.     /**
  269.      * The default currency name
  270.      * @var string
  271.      * @access public
  272.      */
  273.     var $def_currency = 'USD'; // American dollar
  274.  
  275.     // }}}
  276.     // {{{ toWords()
  277.  
  278.     /**
  279.      * Converts a number to its word representation
  280.      * in American English language
  281.      *
  282.      * @param  integer $num   An integer between -infinity and infinity inclusive :)
  283.      *                        that need to be converted to words
  284.      * @param  integer $power The power of ten for the rest of the number to the right.
  285.      *                        Optional, defaults to 0.
  286.      * @param  integer $powsuffix The power name to be added to the end of the return string.
  287.      *                        Used internally. Optional, defaults to ''.
  288.      *
  289.      * @return string  The corresponding word representation
  290.      *
  291.      * @access public
  292.      * @author Piotr Klaban <makler@man.torun.pl>
  293.      * @since  PHP 4.2.3
  294.      */
  295.     function toWords($num, $power = 0, $powsuffix = '') {
  296.       $ret = '';        
  297.       
  298.       // add a minus sign
  299.       if (substr($num, 0, 1) == '-') {
  300.         $ret = $this->_sep . $this->_minus;
  301.         $num = substr($num, 1);
  302.       }
  303.         
  304.       // strip excessive zero signs and spaces
  305.       $num = trim($num);
  306.       $num = preg_replace('/^0+/','',$num);
  307.         
  308.       if (strlen($num) > 3) {
  309.           $maxp = strlen($num)-1;
  310.           $curp = $maxp;
  311.           for ($p = $maxp; $p > 0; --$p) { // power
  312.             
  313.             // check for highest power
  314.             if (isset($this->_exponent[$p])) {
  315.               // send substr from $curp to $p
  316.               $snum = substr($num, $maxp - $curp, $curp - $p + 1);
  317.               $snum = preg_replace('/^0+/','',$snum);
  318.               if ($snum !== '') {
  319.                   $cursuffix = $this->_exponent[$power][count($this->_exponent[$power])-1];
  320.                   if ($powsuffix != '')
  321.                     $cursuffix .= $this->_sep . $powsuffix;
  322.                   $ret .= $this->toWords($snum, $p, $cursuffix);
  323.               }
  324.               $curp = $p - 1;
  325.               continue;
  326.             }
  327.           }
  328.           $num = substr($num, $maxp - $curp, $curp - $p + 1);
  329.           if ($num == 0) {
  330.               return $ret;
  331.           }
  332.       } elseif ($num == 0 || $num == '') {
  333.         return $this->_sep . $this->_digits[0];
  334.       }
  335.     
  336.       $h = $t = $d = 0;
  337.       
  338.       switch(strlen($num)) {
  339.         case 3:
  340.           $h = (int)substr($num,-3,1);
  341.  
  342.         case 2:
  343.           $t = (int)substr($num,-2,1);
  344.  
  345.         case 1:
  346.           $d = (int)substr($num,-1,1);
  347.           break;
  348.  
  349.         case 0:
  350.           return;
  351.           break;
  352.       }
  353.     
  354.       if ($h) {
  355.         $ret .= $this->_sep . $this->_digits[$h] . $this->_sep . 'hundred';
  356.  
  357.         // in English only - add ' and' for [1-9]01..[1-9]99
  358.         // (also for 1001..1099, 10001..10099 but it is harder)
  359.         // for now it is switched off, maybe some language purists
  360.         // can force me to enable it, or to remove it completely
  361.         // if (($t + $d) > 0)
  362.         //   $ret .= $this->_sep . 'and';
  363.       }
  364.  
  365.       // ten, twenty etc.
  366.       switch ($t) {
  367.       case 9:
  368.       case 7:
  369.       case 6:
  370.           $ret .= $this->_sep . $this->_digits[$t] . 'ty';
  371.           break;
  372.     
  373.       case 8:
  374.           $ret .= $this->_sep . 'eighty';
  375.           break;
  376.     
  377.       case 5:
  378.           $ret .= $this->_sep . 'fifty';
  379.           break;
  380.     
  381.       case 4:
  382.           $ret .= $this->_sep . 'forty';
  383.           break;
  384.     
  385.       case 3:
  386.           $ret .= $this->_sep . 'thirty';
  387.           break;
  388.     
  389.       case 2:
  390.           $ret .= $this->_sep . 'twenty';
  391.           break;
  392.     
  393.       case 1:
  394.           switch ($d) {
  395.           case 0:
  396.               $ret .= $this->_sep . 'ten';
  397.               break;
  398.     
  399.           case 1:
  400.               $ret .= $this->_sep . 'eleven';
  401.               break;
  402.     
  403.           case 2:
  404.               $ret .= $this->_sep . 'twelve';
  405.               break;
  406.     
  407.           case 3:
  408.               $ret .= $this->_sep . 'thirteen';
  409.               break;
  410.     
  411.           case 4:
  412.           case 6:
  413.           case 7:
  414.           case 9:
  415.               $ret .= $this->_sep . $this->_digits[$d] . 'teen';
  416.               break;
  417.     
  418.           case 5:
  419.               $ret .= $this->_sep . 'fifteen';
  420.               break;
  421.     
  422.           case 8:
  423.               $ret .= $this->_sep . 'eighteen';
  424.               break;
  425.           }
  426.           break; 
  427.       }
  428.  
  429.       if ($t != 1 && $d > 0) { // add digits only in <0>,<1,9> and <21,inf>
  430.         // add minus sign between [2-9] and digit
  431.         if ($t > 1) {
  432.           $ret .= '-' . $this->_digits[$d];
  433.         } else {
  434.           $ret .= $this->_sep . $this->_digits[$d];
  435.         }
  436.       }
  437.   
  438.       if ($power > 0) {
  439.         if (isset($this->_exponent[$power]))
  440.           $lev = $this->_exponent[$power];
  441.     
  442.         if (!isset($lev) || !is_array($lev))
  443.           return null;
  444.      
  445.         $ret .= $this->_sep . $lev[0];
  446.       }
  447.     
  448.       if ($powsuffix != '')
  449.         $ret .= $this->_sep . $powsuffix;
  450.     
  451.       return $ret;
  452.     }
  453.     // }}}
  454.     // {{{ toCurrencyWords()
  455.  
  456.     /**
  457.      * Converts a currency value to its word representation
  458.      * (with monetary units) in English language
  459.      *
  460.      * @param  integer $int_curr An international currency symbol
  461.      *                 as defined by the ISO 4217 standard (three characters)
  462.      * @param  integer $decimal A money total amount without fraction part (e.g. amount of dollars)
  463.      * @param  integer $fraction Fractional part of the money amount (e.g. amount of cents)
  464.      *                 Optional. Defaults to false.
  465.      * @param  integer $convert_fraction Convert fraction to words (left as numeric if set to false).
  466.      *                 Optional. Defaults to true.
  467.      *
  468.      * @return string  The corresponding word representation for the currency
  469.      *
  470.      * @access public
  471.      * @author Piotr Klaban <makler@man.torun.pl>
  472.      * @since  Numbers_Words 0.4
  473.      */
  474.     function toCurrencyWords($int_curr, $decimal, $fraction = false, $convert_fraction = true) {
  475.         $int_curr = strtoupper($int_curr);
  476.         if (!isset($this->_currency_names[$int_curr])) {
  477.             $int_curr = $this->def_currency;
  478.         }
  479.         $curr_names = $this->_currency_names[$int_curr];
  480.         $ret  = trim($this->toWords($decimal));
  481.         $lev  = ($decimal == 1) ? 0 : 1;
  482.         if ($lev > 0) {
  483.             if (count($curr_names[0]) > 1) {
  484.                 $ret .= $this->_sep . $curr_names[0][$lev];
  485.             } else {
  486.                 $ret .= $this->_sep . $curr_names[0][0] . 's';
  487.             }
  488.         } else {
  489.             $ret .= $this->_sep . $curr_names[0][0];
  490.         }
  491.       
  492.         if ($fraction !== false) {
  493.             if ($convert_fraction) {
  494.                 $ret .= $this->_sep . trim($this->toWords($fraction));
  495.             } else {
  496.                 $ret .= $this->_sep . $fraction;
  497.             }
  498.             $lev  = ($fraction == 1) ? 0 : 1;
  499.             if ($lev > 0) {
  500.                 if (count($curr_names[1]) > 1) {
  501.                     $ret .= $this->_sep . $curr_names[1][$lev];
  502.                 } else {
  503.                     $ret .= $this->_sep . $curr_names[1][0] . 's';
  504.                 }
  505.             } else {
  506.                 $ret .= $this->_sep . $curr_names[1][0];
  507.             }
  508.         }
  509.         return $ret;
  510.     }
  511.     // }}}
  512.  
  513. }
  514.  
  515. ?>
  516.