GetNumericType::from()

Description

GetNumericType::from() returns integer or double if the input variable is a numeric type, or can be automatically coerced into a numeric type by PHP.

use GanbaroDigital\MissingBits\TypeInspectors\GetNumericType;
public static string|null GetNumericType::from(mixed $item);

Parameters

The input parameters are:

• mixed $item - the item to examine

Return Value

GetNumericType::from() returns a string on success, or NULL otherwise.

• If $item is not numeric, NULL is returned.
• If $item is already an integer or a double, we return integer or double accordingly.
• if $item is a string, we convert it to a number, and return integer or double accordingly.

Example Return Values

Here's a list of examples of accepted input values:

var_dump(GetNumericType::from(0.0));

// outputs
//
// string(6) "double"

var_dump(GetNumericType::from(0));

// outputs
//
// string(7) "integer"

var_dump(GetNumericType::from("0.0"));

// outputs
//
// string(6) "double"

var_dump(GetNumericType::from("3.1415927"));

// outputs
//
// string(6) "double"

var_dump(GetNumericType::from("0"));

// outputs
//
// string(7) "integer"

var_dump(GetNumericType::from("100"));

// outputs
//
// string(7) "integer"

Here's a list of examples of ingored input values:

var_dump(GetNumericType::from(null));

// outputs
//
// NULL

var_dump(GetNumericType::from([1,2,3]));

// outputs
//
// NULL

use GanbaroDigital\MissingBits\TypeInspectors\GetStrictTypes;

var_dump(GetNumericType::from([GetStrictTypes::class, "from"]));

// outputs
//
// NULL

var_dump(GetNumericType::from(function(){}));

// outputs
//
// NULL

var_dump(GetNumericType::from(true));

// outputs
//
// NULL

var_dump(GetNumericType::from(false));

// outputs
//
// NULL

var_dump(GetNumericType::from(new ArrayObject));

// outputs
//
// NULL

use GanbaroDigital\MissingBits\TypeInspectors\GetStrictTypes;

var_dump(GetNumericType::from(new GetStrictTypes));

// outputs
//
// NULL

var_dump(GetNumericType::from((object)[]));

// outputs
//
// NULL

var_dump(GetNumericType::from(STDIN));

// outputs
//
// NULL

var_dump(GetNumericType::from("true"));

// outputs
//
// NULL

var_dump(GetNumericType::from("false"));

// outputs
//
// NULL

var_dump(GetNumericType::from("hello, world!"));

// outputs
//
// NULL

var_dump(GetNumericType::from(ArrayObject::class));

// outputs
//
// NULL

var_dump(GetNumericType::from(Traversable::class));

// outputs
//
// NULL

Throws

GetNumericType::from() does not throw any exceptions.

Works With

GetNumericType::from() is supported on these versions of PHP: