settype

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

settype — Устанавливает тип переменной

Описание

function settype(mixed &$var, string $type): bool

Функция устанавливает переменной var тип type.

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

var

Переменная, тип которой требуется преобразовать.

type

Допустимые значения параметра type:

  • "boolean" или "bool"
  • "integer" или "int"
  • "float" или "double"
  • "string"
  • "array"
  • "object"
  • "null"

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Ошибки

Начиная с PHP 8.0.0 выбрасывает исключение ValueError, если значение параметра type не является допустимым типом. До PHP 8.0.0 выдавалась ошибка уровня E_WARNING и возвращалось значение false.

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

Версия Описание
8.0.0 Теперь выбрасывает исключение ValueError, когда в параметр type передан недопустимый тип. Раньше выдавалась ошибка уровня E_WARNING и функция возвращала false.

Примеры

Пример #1 Пример установки типа переменной функцией settype()

<?php

$foo = "5bar"; // Строка
$bar = true; // Логическое значение

settype($foo, "integer"); // Значение переменной $foo теперь равно 5 и принадлежит целочисленному типу
settype($bar, "string"); // Значение переменной $bar теперь равно "1" и принадлежит строковому типу

var_dump($foo, $bar);

Примечания

Замечание:

Максимальное значение для типа "int" равно значению константы PHP_INT_MAX.

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