svn: /phpdoc/de/trunk/reference/ spl/book.xml var/functions/get-resource-type.xml var/functions/var-export.xml

Added: phpdoc/de/trunk/reference/spl/book.xml
===================================================================
--- phpdoc/de/trunk/reference/spl/book.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/spl/book.xml	2011-07-02 08:44:04 UTC (rev 312804)
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 289297 Maintainer: hholzgra Status: ready -->
+
+<book xml:id="book.spl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Standard PHP Library (SPL)</title>
+ <titleabbrev>SPL</titleabbrev>
+
+ <preface xml:id="intro.spl">
+  &reftitle.intro;
+  <para>
+   SPL ist eine Sammlung von Interfacen und Klassen für die Lösung
+   von standardproblemen.
+  </para>
+  <note>
+   <para>
+    Die ursprüngliche "doxygen" Dokuemntation findet sich
+    <link xlink:href="&url.spl.doxygen;">hier</link>.
+   </para>
+  </note>
+ </preface>
+
+ &reference.spl.setup;
+ &reference.spl.constants;
+ &reference.spl.datastructures;
+ &reference.spl.iterators;
+ &reference.spl.interfaces;
+ &reference.spl.exceptions;
+ &reference.spl.reference;
+ &reference.spl.files;
+ &reference.spl.miscellaneous;
+
+<!-- TODO: Not documented
+ &reference.spl.splfixedarray;
+ &reference.spl.splobjectstorage;
+-->
+
+</book>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+


Property changes on: phpdoc/de/trunk/reference/spl/book.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native

Added: phpdoc/de/trunk/reference/var/functions/get-resource-type.xml
===================================================================
--- phpdoc/de/trunk/reference/var/functions/get-resource-type.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/var/functions/get-resource-type.xml	2011-07-02 08:44:04 UTC (rev 312804)
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 297028 Maintainer: hholzgra Status: ready -->
+<refentry xml:id="function.get-resource-type" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>get_resource_type</refname>
+  <refpurpose>
+   Liefert den Typ einer Resource
+  </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>get_resource_type</methodname>
+   <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Diese Funktion ermittelt den Typ der übergebenen Resource.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>handle</parameter></term>
+     <listitem>
+      <para>
+       Ein Resource Handle.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Ist der Parameter <parameter>handle</parameter> eine Resource so
+   gibt die Funktion eine textuelle Repräsentation des Resource-Typen
+   zurück. Kann der Typ nicht von dieser Funktion ermittelt werden so
+   wird der String <literal>Unknown</literal> zurückgegeben.
+  </para>
+  <para>
+   Die Funktion gibt &false; zurück und erzeugt eine Fehlermeldung wenn
+   <parameter>handle</parameter> nicht vom Typ <type>resource</type> ist.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>get_resource_type</function> Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Ergebnis: mysql link
+$c = mysql_connect();
+echo get_resource_type($c) . "\n";
+
+// Gergebnis: file
+$fp = fopen("foo", "w");
+echo get_resource_type($fp) . "\n";
+
+// Ergebnis: domxml document
+$doc = new_xmldoc("1.0");
+echo get_resource_type($doc->doc) . "\n";
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/de/trunk/reference/var/functions/get-resource-type.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native

Added: phpdoc/de/trunk/reference/var/functions/var-export.xml
===================================================================
--- phpdoc/de/trunk/reference/var/functions/var-export.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/var/functions/var-export.xml	2011-07-02 08:44:04 UTC (rev 312804)
@@ -0,0 +1,259 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 311626 Maintainer: hholzgra Status: ready -->
+<refentry xml:id="function.var-export" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>var_export</refname>
+  <refpurpose>Gibt den Inhalt einer Variablen als parsbaren PHP-Code zurück</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>mixed</type><methodname>var_export</methodname>
+   <methodparam><type>mixed</type><parameter>expression</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   <function>var_export</function> liefert strukturierte Informationen
+   zum Inhalt der übergebenen Variable. Das Verhalten ist ähnlich dem
+   der <function>var_dump</function>, allerdings ist hier das Ergebnis
+   valider PHP-Code mit dem sich der Inhalt der Variable wieder herstellen
+   lässt.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>expression</parameter></term>
+     <listitem>
+      <para>
+       Die zu exportierende Variable.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>return</parameter></term>
+     <listitem>
+      <para>
+       Wird dieser Parameter auf &true; gesetzt so wird das Ergebnis nicht
+       direkt ausgegeben sondern als &string; zurückgegeben.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Liefert die Repräsentation der Variablen als PHP-Code wenn der
+   <parameter>return</parameter> genutzt wird und als Wert &true;
+   ergibt. Anderenfalls gibt die Funktion &null; zurück.
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.uses-ob;
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.1.0</entry>
+       <entry>
+        Möglichkeit Klassen und Arrays die Klassen enthalten mit Hilfe der
+        'magischen' <link linkend="language.oop5.magic.set-state">__set_state</link>
+        Methode zu exportieren.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>var_export</function> Beispiel</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$a = array (1, 2, array ("a", "b", "c"));
+var_export($a);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array (
+  0 => 1,
+  1 => 2,
+  2 =>
+  array (
+    0 => 'a',
+    1 => 'b',
+    2 => 'c',
+  ),
+)
+]]>
+    </screen>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$b = 3.1;
+$v = var_export($b, true);
+echo $v;
+
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+3.1
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Export von Klassen ab PHP 5.1.0</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class A { public $var; }
+$a = new A;
+$a->var = 5;
+var_export($a);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+A::__set_state(array(
+   'var' => 5,
+))
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Nutzung von <link linkend="language.oop5.magic.set-state">__set_state</link> (ab PHP 5.1.0)</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class A
+{
+    public $var1;
+    public $var2;
+
+    public static function __set_state($an_array)
+    {
+        $obj = new A;
+        $obj->var1 = $an_array['var1'];
+        $obj->var2 = $an_array['var2'];
+        return $obj;
+    }
+}
+
+$a = new A;
+$a->var1 = 5;
+$a->var2 = 'foo';
+
+eval('$b = ' . var_export($a, true) . ';'); // $b = A::__set_state(array(
+                                            //    'var1' => 5,
+                                            //    'var2' => 'foo',
+                                            // ));
+var_dump($b);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(A)#2 (2) {
+  ["var1"]=>
+  int(5)
+  ["var2"]=>
+  string(3) "foo"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Variablen vom Typ <type>resource</type> können von dieser Funktion
+    nicht exportiert werden.
+   </para>
+  </note>
+  <note>
+   <para>
+    <function>var_export</function> ist nicht in der Lage zirkuläre
+    Referenzen aufzulösen da es annähernd unmöglich ist hierfür
+    gültigen PHP-Code zu erzeugen. In solchen Fällen empfiehlt sich
+    statt dessen die Nutzung der <function>serialize</function> für
+    eine vollständige Repräsentation von entsprechenden Arrays oder
+    Objekten.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>print_r</function></member>
+    <member><function>serialize</function></member>
+    <member><function>var_dump</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/de/trunk/reference/var/functions/var-export.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native