compact
(PHP 4, PHP 5, PHP 7, PHP 8)
compact — Erstellt ein Array mit Variablen und deren Werten
Beschreibung
$var_name, array|string ...$var_names): arrayErstellt ein Array mit Variablen und deren Werten.
Für jede dieser Variablen sucht compact() nach einer Variablen in der aktuellen Symboltabelle, und fügt diese dem zurückzugebenden Array hinzu, wobei der Variablenname als Schlüssel, und der Inhalt der Variablen als Wert gespeichert wird. Kurz gesagt, diese Funktion tut das Gegenteil von extract().
Hinweis:
Vor PHP 7.3 wurden Strings, welche nicht gesetzt sind, stillschweigend ignoriert.
Parameter-Liste
-
var_name -
var_names -
compact() übernimmt eine variable Anzahl von Parametern. Jeder Parameter kann entweder ein String mit einem Variablennamen, oder ein Array mit Variablennamen sein. Dieses Array kann auch andere Arrays mit Variablennamen enthalten; compact() behandelt sie rekursiv.
Rückgabewerte
Gibt ein Array mit allen Variablen zurück.
Fehler/Exceptions
compact() erzeugt eine Fehlermeldung der Stufe E_NOTICE, wenn sich ein gegebener String auf eine nicht gesetzte Variable bezieht.
Changelog
| Version | Beschreibung |
|---|---|
| 7.3.0 | compact() erzeugt nun eine Fehlermeldung der Stufe E_NOTICE, wenn sich ein gegebener String auf eine nicht gesetzte Variable bezieht. Zuvor wurden solche Strings stillschweigend ausgelassen. |
Beispiele
Beispiel #1 compact()-Beispiel
<?php
$city = "San Francisco";
$state = "CA";
$event = "SIGGRAPH";
$location_vars = array("city", "state");
$result = compact("event", $location_vars);
print_r($result);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array
(
[event] => SIGGRAPH
[city] => San Francisco
[state] => CA
)
Anmerkungen
Hinweis: Achtung
Weil variable Variablen in Funktionen nicht mit PHPs superglobalen Arrays verwendet werden dürfen, können die superglobalen Arrays nicht an compact() übergeben werden.
