source: branches/1.2/workflow/inc/class.utils.type.php @ 1349

<?php
require_once('class.utils.php');
/**
 * Contains useful methods for PHP type checking and casting
 * @author Carlos Eduardo Nogueira Gonçalves
 * @author Marcos Pont
 * @version 1.0
 * @link http://workflow.celepar.parana/doc-workflow/classes/typeutils Complete reference
 * @package Workflow
 * @license http://www.gnu.org/copyleft/gpl.html GPL
 */
class TypeUtils extends Utils
{       
        /**
         * Return the type of variable
         * @param $value 
         * @return type of element
         * @access public
         */
        function getType($value) {
                return gettype($value);
        }
        
        /**
         * Check if value is a float number
         * @param int  $value 
         * @param bool $stritct
         * @access public
         * @return bool 
         */
        function isFloat(&$value, $strict=FALSE) {
                $locale = localeconv();
                $dp = $locale['decimal_point'];
                $exp = "/^\-?[0-9]+(\\" . $dp . "[0-9]+)?$/";
                if (preg_match($exp, $value)) {
                        if (!$strict && !is_float($value)) {
                                $value = $this->parseFloat($value);
                        }
                        return TRUE;
                } else {
                        return FALSE;
                }
        }
        
        /**
         * Parse Float number
         * @param string $value
         * @access public
         * @return float
         */
        function parseFloat($value) {
                if ($this->isString($value)) {
                        $locale = localeconv();
                        if ($locale['decimal_point'] != '.') {
                                $value = str_replace($locale['decimal_point'], '.', $value);
                        }
                }
                return floatval($value);
        }
        
        
        /**
         * Parse Float Positive
         * @param string $value
         * @access public
         * @return int
         */
        function parseFloatPositive($value) {
                return abs(floatval($value));
        }
        
        /**
         * Checks if $value is a string
         * @param string $value
         * @access public
         * @return bool
         */
        function isString($value) {
                return is_string($value);
        }

        /**
         * Checks if $values is a array
         * @param string $value
         * @access public
         * @return bool
         */
        function isArray($value) {
                return is_array($value);
        }
        
        /**
         * Checks if $value is a Hash array
         * @param string $value
         * @access public
         * @return bool
         */
        function isHashArray($value) {
                if (is_array($value) && sizeof($value)) {
                        $i = 0;
                        $keys = array_keys($value);
                        foreach ($keys as $k=>$v) {
                                if ($v !== $i) {
                                        return TRUE;
                                }
                                $i++;
                        }
                }
                return FALSE;
        }
        
        /**
         * the value to array
         * @param mixed $value 
         * @access public
         * @return array
         */
        function toArray($value) {
                return is_array($value) ? $value : array($value);
        }
        
        /**
         * Check if the parameter is a object
         * @param mixed $value type to test
         * @access public
         * @return bool
         */
        function isObject($value) {
                return is_object($value);
        }
        
        /**
         * Check if object is instance of class
         * @param object $object
         * @param string $className
         * @param bool   $recurse
         * @return bool
         * @access public
         */
        function isInstanceOf($object, $className, $recurse=TRUE) {
                if (!is_object($object))
                        return FALSE;
                $objClass = get_class($object);
                $otherClass = ($this->isPHP(5) ? $className : strtolower($className));
                if ($recurse)
                        return ($objClass == $otherClass || is_subclass_of($object, $otherClass));
                return ($objClass == $otherClass);
        }
        
        /**
         * Check if the parameter is a Resource 
         * @param mixed $value
         * @return bool
         * @access public
         */
        function isResource($value) {
                if (is_resource($value))
                        return get_resource_type($value);
                return FALSE;
        }

        /**
         * Checks if the value is a boolean
         * @param mixed $value
         * @return bool
         * @access public
         */
        function isBoolean($value) {
                return ($value === TRUE || $value === FALSE);
        }
        
        /**
         * Check if the value is a boolean and true
         * @param bool $value
         * @return bool  
         * @access public
         */
        function isTrue($value) {
                return ($value === TRUE);
        }

        /**
         * Return a default value if first parameter is false
         * @param  mixed $value   test value
         * @param  mixed $default default value to return if first parameter is false
         * @access public
         */
        function ifFalse($value, $default = FALSE) {
                if ($value === FALSE)
                        return $default;
                return $value;
        }
        
        /**
         * Converts value to boolean 0 false otherwise true
         * @param mixed $value
         * @return bool true or false
         * @access public
         */
        function toBoolean($value) {
                return (bool)$value;
        }
        
        /**
         * Checks if value parameter is empty
         * @param mixed $value
         * @return bool true empty otherwise false 
         * @access public
         */
        function isEmpty($value) {
                $result = empty($value);
                return $result;
        }
}
?>