ExcelError
in package
uses
ArrayEnabled
Table of Contents
Constants
- ERROR_CODES = [ 'null' => '#NULL!', // 1 'divisionbyzero' => '#DIV/0!', // 2 'value' => '#VALUE!', // 3 'reference' => '#REF!', // 4 'name' => '#NAME?', // 5 'num' => '#NUM!', // 6 'na' => '#N/A', // 7 'gettingdata' => '#GETTING_DATA', // 8 'spill' => '#SPILL!', // 9 'connect' => '#CONNECT!', //10 'blocked' => '#BLOCKED!', //11 'unknown' => '#UNKNOWN!', //12 'field' => '#FIELD!', //13 'calculation' => '#CALC!', ]
- List of error codes.
Properties
Methods
- CALC() : string
- CALC.
- DIV0() : string
- DIV0.
- NA() : string
- NA.
- NAME() : string
- NAME.
- NAN() : string
- NaN.
- null() : string
- NULL.
- REF() : string
- REF.
- throwError() : string
- type() : array<string|int, mixed>|int|string
- ERROR_TYPE.
- VALUE() : string
- VALUE.
- evaluateArrayArguments() : array<string|int, mixed>
- Handles array argument processing when the function accepts multiple arguments, and any of them can be an array argument.
- evaluateArrayArgumentsIgnore() : array<string|int, mixed>
- Handles array argument processing when the function accepts multiple arguments, and any of them can be an array argument except for the one specified by ignore.
- evaluateArrayArgumentsSubset() : array<string|int, mixed>
- Handles array argument processing when the function accepts multiple arguments, but only the first few (up to limit) can be an array arguments.
- evaluateArrayArgumentsSubsetFrom() : array<string|int, mixed>
- Handles array argument processing when the function accepts multiple arguments, but only the last few (from start) can be an array arguments.
- evaluateSingleArgumentArray() : array<string|int, mixed>
- Handles array argument processing when the function accepts a single argument that can be an array argument.
- initialiseHelper() : void
- testFalse() : bool
Constants
ERROR_CODES
List of error codes.
public
array<string, string>
ERROR_CODES
= [
'null' => '#NULL!',
// 1
'divisionbyzero' => '#DIV/0!',
// 2
'value' => '#VALUE!',
// 3
'reference' => '#REF!',
// 4
'name' => '#NAME?',
// 5
'num' => '#NUM!',
// 6
'na' => '#N/A',
// 7
'gettingdata' => '#GETTING_DATA',
// 8
'spill' => '#SPILL!',
// 9
'connect' => '#CONNECT!',
//10
'blocked' => '#BLOCKED!',
//11
'unknown' => '#UNKNOWN!',
//12
'field' => '#FIELD!',
//13
'calculation' => '#CALC!',
]
Properties
$arrayArgumentHelper
private
static ArrayArgumentHelper
$arrayArgumentHelper
$initializationNeeded
private
static bool
$initializationNeeded
= true
Methods
CALC()
CALC.
public
static CALC() : string
Return values
string —#CALC!
DIV0()
DIV0.
public
static DIV0() : string
Return values
string —#DIV/0!
NA()
NA.
public
static NA() : string
Excel Function: =NA()
Returns the error value #N/A #N/A is the error value that means "no value is available."
Return values
string —#N/A!
NAME()
NAME.
public
static NAME() : string
Returns the error value #NAME?
Return values
string —#NAME?
NAN()
NaN.
public
static NAN() : string
Returns the error value #NUM!
Return values
string —#NUM!
null()
NULL.
public
static null() : string
Returns the error value #NULL!
Return values
string —#NULL!
REF()
REF.
public
static REF() : string
Returns the error value #REF!
Return values
string —#REF!
throwError()
public
static throwError(mixed $value) : string
Parameters
- $value : mixed
Return values
stringtype()
ERROR_TYPE.
public
static type([mixed $value = '' ]) : array<string|int, mixed>|int|string
Parameters
- $value : mixed = ''
-
Value to check
Return values
array<string|int, mixed>|int|stringVALUE()
VALUE.
public
static VALUE() : string
Returns the error value #VALUE!
Return values
string —#VALUE!
evaluateArrayArguments()
Handles array argument processing when the function accepts multiple arguments, and any of them can be an array argument.
protected
static evaluateArrayArguments(callable $method, mixed ...$arguments) : array<string|int, mixed>
Example use for: ROUND() or DATE().
Parameters
- $method : callable
- $arguments : mixed
Return values
array<string|int, mixed>evaluateArrayArgumentsIgnore()
Handles array argument processing when the function accepts multiple arguments, and any of them can be an array argument except for the one specified by ignore.
protected
static evaluateArrayArgumentsIgnore(callable $method, int $ignore, mixed ...$arguments) : array<string|int, mixed>
Example use for: HLOOKUP() and VLOOKUP(), where argument 1 is a matrix that needs to be treated as a database rather than as an array argument.
Parameters
- $method : callable
- $ignore : int
- $arguments : mixed
Return values
array<string|int, mixed>evaluateArrayArgumentsSubset()
Handles array argument processing when the function accepts multiple arguments, but only the first few (up to limit) can be an array arguments.
protected
static evaluateArrayArgumentsSubset(callable $method, int $limit, mixed ...$arguments) : array<string|int, mixed>
Example use for: NETWORKDAYS() or CONCATENATE(), where the last argument is a matrix (or a series of values) that need to be treated as a such rather than as an array arguments.
Parameters
- $method : callable
- $limit : int
- $arguments : mixed
Return values
array<string|int, mixed>evaluateArrayArgumentsSubsetFrom()
Handles array argument processing when the function accepts multiple arguments, but only the last few (from start) can be an array arguments.
protected
static evaluateArrayArgumentsSubsetFrom(callable $method, int $start, mixed ...$arguments) : array<string|int, mixed>
Example use for: Z.TEST() or INDEX(), where the first argument 1 is a matrix that needs to be treated as a dataset rather than as an array argument.
Parameters
- $method : callable
- $start : int
- $arguments : mixed
Return values
array<string|int, mixed>evaluateSingleArgumentArray()
Handles array argument processing when the function accepts a single argument that can be an array argument.
protected
static evaluateSingleArgumentArray(callable $method, array<string|int, mixed> $values) : array<string|int, mixed>
Example use for: DAYOFMONTH() or FACT().
Parameters
- $method : callable
- $values : array<string|int, mixed>
Return values
array<string|int, mixed>initialiseHelper()
private
static initialiseHelper(array<string|int, mixed>|false $arguments) : void
Parameters
- $arguments : array<string|int, mixed>|false
-
Can be changed to array for Php8.1+
testFalse()
private
static testFalse(mixed $value) : bool
Parameters
- $value : mixed