52 lines
2.2 KiB
PHP
52 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace PhpOffice\PhpSpreadsheet\Calculation\Database;
|
|
|
|
use PhpOffice\PhpSpreadsheet\Calculation\Information\ExcelError;
|
|
|
|
class DGet extends DatabaseAbstract
|
|
{
|
|
/**
|
|
* 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)
|
|
*
|
|
* @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 int|string $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 evaluate($database, $field, $criteria)
|
|
{
|
|
$field = self::fieldExtract($database, $field);
|
|
if ($field === null) {
|
|
return ExcelError::VALUE();
|
|
}
|
|
|
|
$columnData = self::getFilteredColumn($database, $field, $criteria);
|
|
if (count($columnData) > 1) {
|
|
return ExcelError::NAN();
|
|
}
|
|
|
|
$row = array_pop($columnData);
|
|
|
|
return array_pop($row);
|
|
}
|
|
}
|