cvs: phpdoc-de /reference/var/functions print-r.xml

From: Date: Tue, 10 Feb 2004 22:15:26 +0000
Subject: cvs: phpdoc-de /reference/var/functions print-r.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-1092@lists.php.net to get a copy of this message
conni Tue Feb 10 17:15:26 2004 EDT Modified files: /phpdoc-de/reference/var/functions print-r.xml Log: sync to en http://cvs.php.net/diff.php/phpdoc-de/reference/var/functions/print-r.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/var/functions/print-r.xml diff -u phpdoc-de/reference/var/functions/print-r.xml:1.3 phpdoc-de/reference/var/functions/print-r.xml:1.4 --- phpdoc-de/reference/var/functions/print-r.xml:1.3 Tue Sep 17 04:51:40 2002 +++ phpdoc-de/reference/var/functions/print-r.xml Tue Feb 10 17:15:25 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/var.xml, last change in rev 1.4 --> -<!-- last change to 'print-r' in en/ tree in rev 1.5 --> +<!-- $Revision: 1.4 $ --> +<!-- last change to 'print-r' in en/ tree in rev 1.8 --> <refentry id="function.print-r"> <refnamediv> <refname>print_r</refname> @@ -14,38 +13,113 @@ <methodsynopsis> <type>bool</type><methodname>print_r</methodname> <methodparam><type>mixed</type><parameter>expression</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter></methodparam> </methodsynopsis> + <note> + <simpara> + Der Parameter <parameter>return</parameter> wurde in PHP 4.3.0 eingeführt. + </simpara> + </note> + <simpara> + <function>print_r</function> zeigt Informationen über eine + Variable in lesbarer Form an. Wenn die Funktion für eine + Variable vom Typ <type>string</type>, + <type>integer</type> oder <type>float</type> aufgerufen wird, + wird der Wert der Variablen angezeigt. Falls <function>print_r</function> + für ein Array aufgerufen wird, werden die Indizes und Werte + des Arrays angezeigt. Ähnlich wie bei <type>object</type>s. + <function>print_r</function> und <function>var_export</function> + zeigen mit PHP 5 auch private und geschützte Eigenschaften + von Objekten an, im Gegensatz zur Funktion <function>var_dump</function>. + </simpara> + <simpara> + Denken Sie daran, dass ein Aufruf von <function>print_r</function> + den internen Arrayzeiger auf das letzte Element des Arrays setzt. + Um den Zeiger wieder an den Anfang zu setzen, benutzen Sie die + Funktion <function>reset</function>. + </simpara> <para> - Diese Funktion zeigt Informationen über eine Variable oder einen - Ausdruck in lesbarer Form an. Einfache Werte werden direkt ausgegeben, - Arrays und Objekte werden dagegen als eingerückte Schlüssel / - Wert-Paare ausgegeben. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<pre> +<?php + $a = array ('a' => 'Apfel', 'b' => 'Banane', 'c' => array ('x', 'y', 'z')); + print_r ($a); +?> +</pre> +]]> + </programlisting> + <para> + Liefert die Ausgabe: + </para> + <screen> +<![CDATA[ +<pre> +Array +( + [a] => Apfel + [b] => Banane + [c] => Array + ( + [0] => x + [1] => y + [2] => z + ) +) +</pre> +]]> + </screen> + </informalexample> </para> <para> - <function>print_r</function> ähnelt <function>var_dump</function>, gibt - aber Typinformationen nur bei Arrays und Objekten aus. + Wenn Sie die Ausgabe von <function>print_r</function> + zum Weiterverarbeiten abfangen möchten, benutzen Sie + dazu den Parameter <parameter>return</parameter>. Wenn + dieser auf &true; gesetzt ist, gibt <function>print_r</function> + die Ausgabe in einer Variablen zurück, anstatt sie am + Bildschirm auszugeben (was dem Standard entspricht). </para> <para> - <informalexample> + <example> + <title><parameter>return</parameter>Beispiel zur Ausgabe</title> <programlisting role="php"> -&lt;?php -$a = array (1, 2, array ("a", "b", "c")); -print_r ($a); +<![CDATA[ +<?php + $b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z')); + $results = print_r($b, true); //$results enthaelt nun die Ausgabe von print_r() ?> +]]> </programlisting> - </informalexample> + </example> </para> - <warning> - <para> - Diese Funktion ist nicht in der Lage, zyklische Referenzen - aufzulösen, d.h. die Ausgabe eines Arrays oder Objektes, das sich - selbst enthält, wie z.B. <literal>print_r($GLOBALS)</literal>, - wird niemals beendet. - </para> - </warning> + <note> + <simpara> + Falls Sie die Ausgabe von <function>print_r</function> in + einer Version vor PHP 4.3.0 abfangen möchten, können Sie die + <link linkend="ref.outcontrol">Funktionen zur Ausgabesteuerung + </link> benutzen. + </simpara> + </note> + <note> + <simpara> + Vor PHP 4.0.4 erzeugte <function>print_r</function> eine + Endlosschleife, wenn ein übergebenes <type>array</type> oder + <type>object</type> sich selbst direkt oder indirekt referenzierte. + Ein Beispiel dafür ist <literal>print_r($GLOBALS)</literal>, + weil <literal>$GLOBALS</literal> selbst eine globale Variable ist, + und damit eine Referenz auf sich selbst enthält. + </simpara> + </note> + <simpara> + Siehe auch <function>ob_start</function>, + <function>var_dump</function> und + <function>var_export</function>. + </simpara> </refsect1> </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml

« previous php.doc.de (#1092) next »