Subversion Repositories eFlore/Applications.cel

Rev

Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
/**
 * PHPExcel
 *
 * Copyright (c) 2006 - 2013 PHPExcel
 *
 * 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, or (at your option) any later version.
 *
 * 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 *
 * @category    PHPExcel
 * @package             PHPExcel_Calculation
 * @copyright   Copyright (c) 2006 - 2013 PHPExcel (http://www.codeplex.com/PHPExcel)
 * @license             http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt   LGPL
 * @version             ##VERSION##, ##DATE##
 */


/** PHPExcel root directory */
if (!defined('PHPEXCEL_ROOT')) {
        /**
         * @ignore
         */
        define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
        require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
}


/**
 * PHPExcel_Calculation_Database
 *
 * @category    PHPExcel
 * @package             PHPExcel_Calculation
 * @copyright   Copyright (c) 2006 - 2013 PHPExcel (http://www.codeplex.com/PHPExcel)
 */
class PHPExcel_Calculation_Database {


        /**
         * __fieldExtract
         *
         * Extracts the column ID to use for the data field.
         *
         * @access      private
         * @param       mixed[]         $database               The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       mixed           $field                  Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @return      string|NULL
         *
         */
        private static function __fieldExtract($database,$field) {
                $field = strtoupper(PHPExcel_Calculation_Functions::flattenSingleValue($field));
                $fieldNames = array_map('strtoupper',array_shift($database));

                if (is_numeric($field)) {
                        $keys = array_keys($fieldNames);
                        return $keys[$field-1];
                }
                $key = array_search($field,$fieldNames);
                return ($key) ? $key : NULL;
        }

        /**
         * __filter
         *
         * Parses the selection criteria, extracts the database rows that match those criteria, and
         * returns that subset of rows.
         *
         * @access      private
         * @param       mixed[]         $database               The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       mixed[]         $criteria               The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      array of mixed
         *
         */
        private static function __filter($database,$criteria) {
                $fieldNames = array_shift($database);
                $criteriaNames = array_shift($criteria);

                //      Convert the criteria into a set of AND/OR conditions with [:placeholders]
                $testConditions = $testValues = array();
                $testConditionsCount = 0;
                foreach($criteriaNames as $key => $criteriaName) {
                        $testCondition = array();
                        $testConditionCount = 0;
                        foreach($criteria as $row => $criterion) {
                                if ($criterion[$key] > '') {
                                        $testCondition[] = '[:'.$criteriaName.']'.PHPExcel_Calculation_Functions::_ifCondition($criterion[$key]);
                                        $testConditionCount++;
                                }
                        }
                        if ($testConditionCount > 1) {
                                $testConditions[] = 'OR('.implode(',',$testCondition).')';
                                $testConditionsCount++;
                        } elseif($testConditionCount == 1) {
                                $testConditions[] = $testCondition[0];
                                $testConditionsCount++;
                        }
                }

                if ($testConditionsCount > 1) {
                        $testConditionSet = 'AND('.implode(',',$testConditions).')';
                } elseif($testConditionsCount == 1) {
                        $testConditionSet = $testConditions[0];
                }

                //      Loop through each row of the database
                foreach($database as $dataRow => $dataValues) {
                        //      Substitute actual values from the database row for our [:placeholders]
                        $testConditionList = $testConditionSet;
                        foreach($criteriaNames as $key => $criteriaName) {
                                $k = array_search($criteriaName,$fieldNames);
                                if (isset($dataValues[$k])) {
                                        $dataValue = $dataValues[$k];
                                        $dataValue = (is_string($dataValue)) ? PHPExcel_Calculation::_wrapResult(strtoupper($dataValue)) : $dataValue;
                                        $testConditionList = str_replace('[:'.$criteriaName.']',$dataValue,$testConditionList);
                                }
                        }
                        //      evaluate the criteria against the row data
                        $result = PHPExcel_Calculation::getInstance()->_calculateFormulaValue('='.$testConditionList);
                        //      If the row failed to meet the criteria, remove it from the database
                        if (!$result) {
                                unset($database[$dataRow]);
                        }
                }

                return $database;
        }


        /**
         * DAVERAGE
         *
         * Averages the values in a column of a list or database that match conditions you specify.
         *
         * Excel Function:
         *              DAVERAGE(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DAVERAGE($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }
                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::AVERAGE($colData);
        }       //      function DAVERAGE()


        /**
         * DCOUNT
         *
         * Counts the cells that contain numbers in a column of a list or database that match conditions
         * that you specify.
         *
         * Excel Function:
         *              DCOUNT(database,[field],criteria)
         *
         * Excel Function:
         *              DAVERAGE(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      integer
         *
         * @TODO        The field argument is optional. If field is omitted, DCOUNT counts all records in the
         *                      database that match the criteria.
         *
         */
        public static function DCOUNT($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::COUNT($colData);
        }       //      function DCOUNT()


        /**
         * DCOUNTA
         *
         * Counts the nonblank cells in a column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DCOUNTA(database,[field],criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      integer
         *
         * @TODO        The field argument is optional. If field is omitted, DCOUNTA counts all records in the
         *                      database that match the criteria.
         *
         */
        public static function DCOUNTA($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::COUNTA($colData);
        }       //      function DCOUNTA()


        /**
         * DGET
         *
         * Extracts a single value from a column of a list or database that matches conditions that you
         * specify.
         *
         * Excel Function:
         *              DGET(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      mixed
         *
         */
        public static function DGET($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                if (count($colData) > 1) {
                        return PHPExcel_Calculation_Functions::NaN();
                }

                return $colData[0];
        }       //      function DGET()


        /**
         * DMAX
         *
         * Returns the largest number in a column of a list or database that matches conditions you that
         * specify.
         *
         * Excel Function:
         *              DMAX(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DMAX($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::MAX($colData);
        }       //      function DMAX()


        /**
         * DMIN
         *
         * Returns the smallest number in a column of a list or database that matches conditions you that
         * specify.
         *
         * Excel Function:
         *              DMIN(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DMIN($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::MIN($colData);
        }       //      function DMIN()


        /**
         * DPRODUCT
         *
         * Multiplies the values in a column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DPRODUCT(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DPRODUCT($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_MathTrig::PRODUCT($colData);
        }       //      function DPRODUCT()


        /**
         * DSTDEV
         *
         * Estimates the standard deviation of a population based on a sample by using the numbers in a
         * column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DSTDEV(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DSTDEV($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::STDEV($colData);
        }       //      function DSTDEV()


        /**
         * DSTDEVP
         *
         * Calculates the standard deviation of a population based on the entire population by using the
         * numbers in a column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DSTDEVP(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DSTDEVP($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::STDEVP($colData);
        }       //      function DSTDEVP()


        /**
         * DSUM
         *
         * Adds the numbers in a column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DSUM(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DSUM($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_MathTrig::SUM($colData);
        }       //      function DSUM()


        /**
         * DVAR
         *
         * Estimates the variance of a population based on a sample by using the numbers in a column
         * of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DVAR(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DVAR($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::VARFunc($colData);
        }       //      function DVAR()


        /**
         * DVARP
         *
         * Calculates the variance of a population based on the entire population by using the numbers
         * in a column of a list or database that match conditions that you specify.
         *
         * Excel Function:
         *              DVARP(database,field,criteria)
         *
         * @access      public
         * @category Database Functions
         * @param       mixed[]                 $database       The range of cells that makes up the list or database.
         *                                                                              A database is a list of related data in which rows of related
         *                                                                              information are records, and columns of data are fields. The
         *                                                                              first row of the list contains labels for each column.
         * @param       string|integer  $field          Indicates which column is used in the function. Enter the
         *                                                                              column label enclosed between double quotation marks, such as
         *                                                                              "Age" or "Yield," or a number (without quotation marks) that
         *                                                                              represents the position of the column within the list: 1 for
         *                                                                              the first column, 2 for the second column, and so on.
         * @param       mixed[]                 $criteria       The range of cells that contains the conditions you specify.
         *                                                                              You can use any range for the criteria argument, as long as it
         *                                                                              includes at least one column label and at least one cell below
         *                                                                              the column label in which you specify a condition for the
         *                                                                              column.
         * @return      float
         *
         */
        public static function DVARP($database,$field,$criteria) {
                $field = self::__fieldExtract($database,$field);
                if (is_null($field)) {
                        return NULL;
                }

                //      reduce the database to a set of rows that match all the criteria
                $database = self::__filter($database,$criteria);
                //      extract an array of values for the requested column
                $colData = array();
                foreach($database as $row) {
                        $colData[] = $row[$field];
                }

                // Return
                return PHPExcel_Calculation_Statistical::VARP($colData);
        }       //      function DVARP()


}       //      class PHPExcel_Calculation_Database