Liefert den Wert einer Konstante

Beschreibung

constant(string $name): mixed

Gibt den Wert der durch name angegebenen Konstante zurück.

constant() ist nützlich, um den Wert einer Konstante abzufragen, deren Namen Sie nicht kennen, d. h. wenn sie in einer Variablen gespeichert ist oder von einer Funktion zurückgegeben wird.

Diese Funktion funktioniert auch mit Klassenkonstanten und Enum-Cases.

Parameter-Liste

name: Der Name der Konstante

Rückgabewerte

Gibt den Wert der Konstante zurück.

Fehler/Exceptions

Wenn die Konstante nicht definiert ist, wird eine Error-Exception ausgelöst. Vor PHP 8.0.0 wurde in diesem Fall ein Fehler der Stufe E_WARNING erzeugt.

Changelog

Version	Beschreibung
8.0.0	Wenn die Konstante nicht definiert ist, löst constant() nun eine Error-Exception aus; vorher wurde ein Fehler der Stufe `E_WARNING` erzeugt und `null` zurückgegeben.

Beispiele

Beispiel #1 Verwendung von constant() mit Konstanten

<?php

define("MAXGROESSE", 100);

echo MAXGROESSE;
echo constant("MAXGROESSE"); // dasselbe wie in der vorigen Zeile



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!"

?>

Beispiel #2 Verwendung von constant() mit Enum-Cases (seit 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)

?>

Siehe auch

define() - Definiert eine benannte Konstante
defined() - Prüft, ob eine Konstante mit dem angegebenen Namen existiert
get_defined_constants() - Returns an associative array with the names of all the constants and their values
Das Kapitel über Konstanten