intval

(PHP 4, PHP 5, PHP 7, PHP 8)

intval — Возвращает целое значение переменной

Описание

intval(mixed $value, int $base = 10): int

Возвращает целое (int) значение переменной value, используя указанное основание системы счисления base для преобразования (по умолчанию основание равно 10). intval() нельзя использовать с объектами, попытка это сделать вызовет ошибку уровня E_WARNING и вернёт значение 1.

Список параметров

value

Скалярное значение для конвертации в целое

base

Основание системы счисления для преобразования

Замечание:

Если base равно 0, основание системы счисления определяется форматом value:

  • если строка включает префикс "0x" (или "0X"), основание выбирается равным 16 (шестнадцатеричным);
  • иначе, если строка начинается с "0", основание равно 8 (восьмеричное);
  • иначе, основание выбирается равным 10 (десятеричным).

Возвращаемые значения

Целое значение переменной value в случае успешного выполнения, или 0 в случае неудачи. Для пустых массивов возвращается 0, для непустых возвращается 1.

Максимальное значение зависит от операционной системы. В 32-х битных системах максимальное знаковое целое лежит в диапазоне от -2147483648 до 2147483647. Так, например, в такой системе, intval('1000000000000') вернёт 2147483647. Максимальное знаковое целое значение для 64-х битных систем - 9223372036854775807.

Для строк функция скорее всего вернёт 0, хотя это зависит от первого символа в строке. Применяются общие правила преобразований в целые.

Список изменений

Версия Описание
8.0.0 Уровень ошибки при преобразовании из объекта был изменён с E_NOTICE на E_WARNING.

Примеры

Пример #1 Примеры использования intval()

Следующие примеры приведены для 64-х битной системы.

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

Примечания

Замечание:

Параметр base применяется только в том случае, если параметр value является строкой.

Смотрите также