cvs: phpdoc-de /reference/var/functions print-r.xml
| From: | Cornelia Boenigk | 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">
-<?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