Function.print-r
Aus PHP-Wiki
print_r — Gibt Variablen-Informationen in lesbarer Form aus
Inhaltsverzeichnis |
Beschreibung
mixed print_r (mixed $expression [, bool $return ] )
print_r() zeigt Informationen über eine
Variable in menschenlesbarer Form an.
print_r(), var_dump() und
var_export() zeigen mit PHP 5 auch private und geschützte
Eigenschaften von Objekten an. Statische Klasseneigenschaften werden hingegen
nicht angezeigt.
Denken Sie daran, dass ein Aufruf von print_r()
den internen Arrayzeiger auf das letzte Element des Arrays setzt.
Um den Zeiger wieder an den Anfang zu setzen, benutzen Sie die
Funktion reset().
Parameter-Liste
- expression
- Der auszugebende Ausdruck.
- return
- Wenn Sie die Ausgabe von print_r() zum Weiterverarbeiten abfangen möchten, benutzen Sie dazu den Parameter return . Wenn dieser auf TRUE gesetzt ist, gibt print_r() die Ausgabe in einer Variablen zurück, anstatt sie am Bildschirm auszugeben (was dem Standard entspricht).
Rückgabewerte
Wenn die Funktion für eine Variable vom Typ string, integer oder float aufgerufen wird, wird der Wert der Variablen angezeigt. Falls ein array übergeben wurde, werden die Werte in einem Format angezeigt, das sowohl die Schlüssel als auch die Elemente darstellt. Für Variablen vom Typ object gilt das Gleiche.
Anmerkungen
Hinweis: Diese Funktion benutzt intern
Ausgabenpufferung mit diesem Parameter
und kann daher nicht in einer ob_start() Callbackfunktion
eingesetzt werden.
ChangeLog
Version
Beschreibung
4.3.0
Der Parameter return
wurde hinzugefügt. Wenn Sie
die Ausgabe von print_r() in älteren PHP-Versionen
abfangen müssen, verwenden Sie die Ausgabe-Kontrollfunktionen.
4.0.4
Vor PHP 4.0.4 erzeugte print_r() eine
Endlosschleife, wenn ein übergebenes array oder
object sich selbst direkt oder indirekt referenzierte.
Ein Beispiel dafür ist print_r($GLOBALS),
weil $GLOBALS selbst eine globale Variable ist,
und damit eine Referenz auf sich selbst enthält.
Beispiele
#1 print_r()
<?php $a = array ('a' => 'Apfel', 'b' => 'Banane', 'c' => array ('x', 'y', 'z')); print_r ($a); ?>
Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:Array ( [a] => Apfel [b] => Banane [c] => Array ( [0] => x [1] => y [2] => z ) )
#2 return
<?php $b = array ('a' => 'Affe', 'foo' => 'bar', 'x' => array ('x', 'y', 'z')); $results = print_r($b, true); //$results enthaelt nun die Ausgabe von print_r ?>