constant

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

constantLiefert 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

VersionBeschreibung
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
To Top