File Source for Numbers.class.php

<?php
/**
* @package core
*/
/**
* @var array Contains all hexadecimal numbers.
*/
$HEXARR = array(
"0", "1", "2", "3",
"4", "5", "6", "7",
"8", "9", "A", "B",
"C", "D", "E", "F"
);
/**
*
*/
require_once CLASSPATH."data_structures/ABSTObject.class.php";
/**
* Static methods to handle numeric values.
*
* @static
* @package core
* @version 0.1.96
*
* @author Daniel Plücken <daniel@debakel.net>
*
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (c) 2003 Daniel Plücken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library 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. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class Numbers extends ABSTObject
{
// Constructor
function Numbers()
{}
/**
* Apportions a range of numbers between zero and $rangeEnd in $portions
* commensurate chunks. Then the closest computed value to $value will
* be returned.
*
* Example:
* Numbers::getIntervalRoundingOf( 42, 60, 4 );
* Is the same like:
*
* <code>
* if( $value <= 7 || $value > 52 )
* return = 0;
* else
* if( $value <= 22 && $value > 7 )
* return = 15;
* else
* if( $value <= 37 && $value > 22 )
* return = 30;
* else
* if( $value <= 52 && $value > 37 )
* return = 45;
* </code>
*
* In the upper example the function will return 45.
*
* @version 1.0
* @since 0.1.1
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @static
* @param number $value The value to round to the nearest chunk of the
* range.
* @param number $rangeEnd The end of the range. The range begins at zero.
* For example if you want to round in the range of
* 6 to 9, then set the $rangeEnd to 3 and add 6
* after the rounding.
* @param number $portions How many chunks should create in the range for
* rounding base.
* @return number
*/
function getIntervalRoundingOf( $value, $rangeEnd, $portions )
{
$intervalStepAmount = $rangeEnd / $portions;
$halfIntervalStepAmount = $intervalStepAmount / 2;
$fa = floor($halfIntervalStepAmount);
$ca = ceil($halfIntervalStepAmount);
if( $ca == $fa )
{ # Rounding like a merchant (e.g. rounding up if the value is 0.5
# in a range of 0 and 1)
$ca++;
$fa--;
}
if ( $value <= $fa || $value > ($rangeEnd - $ca) )
return 0;
else
for ( $i = 1; $i < $portions; $i++)
if (
$value <= ( ($i * $intervalStepAmount) + $fa )
&& $value > ( ($i * $intervalStepAmount) - $ca )
)
return ($i * $intervalStepAmount);
}
/**
* Returns a random number in the range between $including_from and
* $including_to. Sets automatically a new random set by microtime for real
* random.
*
* @version 1.0
* @since 0.1.5
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @static
* @param integer $including_from
* @param integer $including_to
* @return number
*/
function random( $including_from, $including_to )
{
srand( (double)microtime() * 1000000 );
return rand( $including_from, $including_to );
}
/**
* Returns a double from a given string. Translates a number from other
* language formates.
*
* @version 1.0
* @since 0.1.95
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @static
* @param string $str_number
* @param string $str_decimal_separator
* @param string $str_thousand_separator
* @return double
*/
function translateDoubleVal(
$str_number,
$str_decimal_separator = ".",
$str_thousand_separator = ","
)
{
$str_out = str_replace( $str_thousand_separator, "", $str_number );
$str_out = str_replace( $str_decimal_separator, ".", $str_out );
return doubleval( $str_out );
}
/**
* Returns the decimal value of a given hexadecimal value.
*
* @version 1.0
* @since 1.6
* @author Daniel Plücken <daniel@debakel.net>
* @access public
* @static
* @param string $string
* @return integer
*/
function hex2int( $string )
{
$out = 0;
$string = strtoupper( $string );
for( $i = 0; $i < strlen( $string ); $i++ )
{
switch( substr( $string, $i, 1 ) )
{
case '0':
$tmp = 0;
break;
case '1':
$tmp = 1;
break;
case '2':
$tmp = 2;
break;
case '3':
$tmp = 3;
break;
case '4':
$tmp = 4;
break;
case '5':
$tmp = 5;
break;
case '6':
$tmp = 6;
break;
case '7':
$tmp = 7;
break;
case '8':
$tmp = 8;
break;
case '9':
$tmp = 9;
break;
case 'A':
$tmp = 10;
break;
case 'B':
$tmp = 11;
break;
case 'C':
$tmp = 12;
break;
case 'D':
$tmp = 13;
break;
case 'E':
$tmp = 14;
break;
case 'F':
$tmp = 15;
break;
default:
$tmp = -1;
break;
}
if( $tmp == -1 )
return -1;
$out += $tmp * pow( 16, (strlen( $string )-1) - $i );
}
return $out;
}
} // End of class Numbers
?>

Source for file Numbers.class.php