constant

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

constantВозвращает значение константы

Описание

constant(string $name): mixed

Функция возвращает значение константы по имени, которое указали в параметре name.

Функция constant() полезна, когда требуется получить значение константы, но имя константы неизвестно. То есть имя константы хранит переменная или возвращает функция.

Функция также работает с константами классов и вариантами перечисления.

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

name

Имя константы.

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

Функция возвращает значение константы.

Ошибки

PHP выбросит исключение Error, если константу не определили. До PHP 8.0.0 выдавалась ошибка уровня E_WARNING.

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

Версия Описание
8.0.0 Теперь функция constant() выбрасывает исключение Error, если константу не определили; раньше выдавалась ошибка уровня E_WARNING и возвращалось значение null.

Примеры

Пример #1 Пример использования функции constant() с константами

<?php

define
("MAXSIZE", 100);

echo
MAXSIZE;
echo
constant("MAXSIZE"); // Результат аналогичен предыдущему выводу


interface bar
{
const
test = 'foobar!';
}

class
foo
{
const
test = 'foobar!';
}

$const = 'test';

var_dump(constant('bar::'. $const)); // string(7) "foobar!"
var_dump(constant('foo::'. $const)); // string(7) "foobar!"

?>

Пример #2 Пример использования функции constant() с вариантами перечисления (начиная с PHP 8.1.0)

<?php

enum Suit
{
case
Hearts;
case
Diamonds;
case
Clubs;
case
Spades;
}

$case = 'Hearts';

var_dump(constant('Suit::'. $case)); // enum(Suit::Hearts)

?>

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

  • define() - Определяет именованную константу
  • defined() - Проверяет, существует ли константа с заданным именем
  • get_defined_constants() - Возвращает ассоциативный массив с именами всех констант и их значений
  • Смотрите раздел Константы