Php/docs/function.intval

From Get docs

intval

(PHP 4, PHP 5, PHP 7)

intvalGet the integer value of a variable


Description

intval ( mixed $var [, int $base = 10 ] ) : int

Returns the int value of var, using the specified base for the conversion (the default is base 10). intval() should not be used on objects, as doing so will emit an E_NOTICE level error and return 1.


Parameters

var

The scalar value being converted to an integer

base

The base for the conversion

Note:

If base is 0, the base used is determined by the format of var:

  • if string includes a "0x" (or "0X") prefix, the base is taken as 16 (hex); otherwise,
  • if string starts with "0", the base is taken as 8 (octal); otherwise,
  • the base is taken as 10 (decimal).


Return Values

The integer value of var on success, or 0 on failure. Empty arrays return 0, non-empty arrays return 1.

The maximum value depends on the system. 32 bit systems have a maximum signed integer range of -2147483648 to 2147483647. So for example on such a system, intval('1000000000000') will return 2147483647. The maximum signed integer value for 64 bit systems is 9223372036854775807.

Strings will most likely return 0 although this depends on the leftmost characters of the string. The common rules of integer casting apply.


Examples

Example #1 intval() examples

The following examples are based on a 32 bit system.


<?phpecho intval(42);                      // 42echo intval(4.2);                     // 4echo intval('42');                    // 42echo intval('+42');                   // 42echo intval('-42');                   // -42echo intval(042);                     // 34echo intval('042');                   // 42echo intval(1e10);                    // 1410065408echo intval('1e10');                  // 1echo intval(0x1A);                    // 26echo intval(42000000);                // 42000000echo intval(420000000000000000000);   // 0echo intval('420000000000000000000'); // 2147483647echo intval(42, 8);                   // 42echo intval('42', 8);                 // 34echo intval(array());                 // 0echo intval(array('foo', 'bar'));     // 1echo intval(false);                   // 0echo intval(true);                    // 1?>

Notes

Note:

The base parameter has no effect unless the var parameter is a string.

See Also