The API

• 1.2.0.7296 RC2
• 1.2 Tests
• 1.1.19.6971

• About CakePHP
• Donate

• CakePHP
• API
• Docs
• Bakery
• Live
• Forge
• Trac

number.php

Go to the documentation of this file.

<?php
/* SVN FILE: $Id: number_8php-source.html 580 2008-07-01 14:45:49Z gwoo $ */

/**
 * Number Helper.
 *
 * Methods to make numbers more readable.
 *
 * PHP versions 4 and 5
 *
 * CakePHP(tm) :  Rapid Development Framework <http://www.cakephp.org/>
 * Copyright 2005-2008, Cake Software Foundation, Inc.
 *                              1785 E. Sahara Avenue, Suite 490-204
 *                              Las Vegas, Nevada 89104
 *
 * Licensed under The MIT License
 * Redistributions of files must retain the above copyright notice.
 *
 * @filesource
 * @copyright       Copyright 2005-2008, Cake Software Foundation, Inc.
 * @link                http://www.cakefoundation.org/projects/info/cakephp CakePHP(tm) Project
 * @package         cake
 * @subpackage      cake.cake.libs.view.helpers
 * @since           CakePHP(tm) v 0.10.0.1076
 * @version         $Revision: 580 $
 * @modifiedby      $LastChangedBy: gwoo $
 * @lastmodified    $Date: 2008-07-01 09:45:49 -0500 (Tue, 01 Jul 2008) $
 * @license         http://www.opensource.org/licenses/mit-license.php The MIT License
 */

/**
 * Number helper library.
 *
 * Methods to make numbers more readable.
 *
 * @package     cake
 * @subpackage  cake.cake.libs.view.helpers
 */
class NumberHelper extends AppHelper {
/**
 * Formats a number with a level of precision.
 *
 * @param  float    $number A floating point number.
 * @param  integer $precision The precision of the returned number.
 * @return float Enter description here...
 * @static
 */
    function precision($number, $precision = 3) {
        return sprintf("%01.{$precision}f", $number);
    }

/**
 * Returns a formatted-for-humans file size.
 *
 * @param integer $length Size in bytes
 * @return string Human readable size
 * @static
 */
    function toReadableSize($size) {
        switch($size) {
            case 0:
                return '0 Bytes';
            case 1:
                return '1 Byte';
            case $size < 1024:
                return $size . ' Bytes';
            case $size < 1024 * 1024:
                return $this->precision($size / 1024, 0) . ' KB';
            case $size < 1024 * 1024 * 1024:
                return $this->precision($size / 1024 / 1024, 2) . ' MB';
            case $size < 1024 * 1024 * 1024 * 1024:
                return $this->precision($size / 1024 / 1024 / 1024, 2) . ' GB';
            case $size < 1024 * 1024 * 1024 * 1024 * 1024:
                return $this->precision($size / 1024 / 1024 / 1024 / 1024, 2) . ' TB';
        }
    }
/**
 * Formats a number into a percentage string.
 *
 * @param float $number A floating point number
 * @param integer $precision The precision of the returned number
 * @return string Percentage string
 * @static
 */
    function toPercentage($number, $precision = 2) {
        return $this->precision($number, $precision) . '%';
    }
/**
 * Formats a number into a currency format.
 *
 * @param float $number A floating point number
 * @param integer $options if int then places, if string then before, if (,.-) then use it
 *                          or array with places and before keys
 * @return string formatted number
 * @static
 */
    function format($number, $options = false) {
        $places = 0;
        if (is_int($options)) {
            $places = $options;
        }

        $separators = array(',', '.', '-', ':');

        $before = $after = null;
        if (is_string($options) && !in_array($options, $separators)) {
            $before = $options;
        }
        $thousands = ',';
        if (!is_array($options) && in_array($options, $separators)) {
            $thousands = $options;
        }
        $decimals = '.';
        if (!is_array($options) && in_array($options, $separators)) {
            $decimals = $options;
        }

        $escape = true;
        if (is_array($options)) {
            $options = array_merge(array('before'=>'$', 'places' => 2, 'thousands' => ',', 'decimals' => '.'), $options);
            extract($options);
        }

        $out = $before . number_format($number, $places, $decimals, $thousands) . $after;

        if ($escape) {
            return h($out);
        }
        return $out;
    }
/**
 * Formats a number into a currency format.
 *
 * @param float $number
 * @param string $currency Shortcut to default options. Valid values are 'USD', 'EUR', 'GBP', otherwise
 *               set at least 'before' and 'after' options.
 * @param array $options
 * @return string Number formatted as a currency.
 */
    function currency($number, $currency = 'USD', $options = array()) {
        $default = array(
            'before'=>'', 'after' => '', 'zero' => '0', 'places' => 2, 'thousands' => ',',
            'decimals' => '.','negative' => '()', 'escape' => true
        );
        $currencies = array(
            'USD' => array(
                'before' => '$', 'after' => 'c', 'zero' => 0, 'places' => 2, 'thousands' => ',',
                'decimals' => '.', 'negative' => '()', 'escape' => true
            ),
            'GBP' => array(
                'before'=>'&#163;', 'after' => 'p', 'zero' => 0, 'places' => 2, 'thousands' => ',',
                'decimals' => '.', 'negative' => '()','escape' => false
            ),
            'EUR' => array(
                'before'=>'&#8364;', 'after' => 'c', 'zero' => 0, 'places' => 2, 'thousands' => '.',
                'decimals' => ',', 'negative' => '()', 'escape' => false
            )
        );

        if (isset($currencies[$currency])) {
            $default = $currencies[$currency];
        } elseif (is_string($currency)) {
            $options['before'] = $currency;
        }

        $options = array_merge($default, $options);

        $result = null;

        if ($number == 0 ) {
            if ($options['zero'] !== 0 ) {
                return $options['zero'];
            }
            $options['after'] = null;
        } elseif ($number < 1 && $number > -1 ) {
            $multiply = intval('1' . str_pad('', $options['places'], '0'));
            $number = $number * $multiply;
            $options['before'] = null;
            $options['places'] = null;
        } else {
            $options['after'] = null;
        }

        $abs = abs($number);
        $result = $this->format($abs, $options);

        if ($number < 0 ) {
            if($options['negative'] == '()') {
                $result = '(' . $result .')';
            } else {
                $result = $options['negative'] . $result;
            }
        }
        return $result;
    }
}

?>

© 2007 Cake Software Foundation