<?php

namespace ski;



/**
 * A utility class related to math operations.
 */
class math
{
	/* PUBLIC */

    /**
     * Swaps the values of two variables.
     * @param integer/mixed $a
     * @param integer/mixed $b
     */
    public static function swap( &$a, &$b )
    {
        $swap = $a;
        $a = $b;
        $b = $swap;
    }
    
    /**
     * Clamp a value between two numbers.
     * @param integer $value The number to clamp
     * @param integer $min The minimum the clamped number can be
     * @param integer $max The maximum the clamped number can be
     * @return integer The clamped number
     */
	public static function clamp( $value, $min, $max )
	{
        //  Ensure the min and max were passed in correctly.
        if ( $min > $max ) swap( $min, $max );
        
        //  Clamp the value.
        $x = $value;
        $x = min( $x, $max );
        $x = max( $x, $min );
        return $x;
	}
	
	/* PRIVATE */

	/**
	 * Only use this class as a utility..
	 */
	private function __construct()
	{
		//	Intentionally blank..
	}
}


?>