 |
 |
 |
 |
|
|
Date: 08/14/00
- Next message: Egon Schmid: "[PHP-DOC] cvs: phpdoc /de/functions vmailmgr.xml"
- Previous message: Jan Lehnardt: "Re: [PHP-DOC] Error building German manual"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
jan Mon Aug 14 07:43:08 2000 EDT
Modified files:
/phpdoc/de/functions wddx.xml
Log:
Translated wddx.xml into German. BTW: I'm not a windows looser. Just haven't looked at the DTD. Sorry again.
Index: phpdoc/de/functions/wddx.xml
diff -u phpdoc/de/functions/wddx.xml:1.3 phpdoc/de/functions/wddx.xml:1.4
--- phpdoc/de/functions/wddx.xml:1.3 Sat Jun 24 00:38:43 2000
+++ phpdoc/de/functions/wddx.xml Mon Aug 14 07:43:08 2000
@@ -1,263 +1,265 @@
- <reference id="ref.wddx">
- <title>WDDX functions</title>
- <titleabbrev>WDDX</titleabbrev>
-
- <partintro>
- <para>
- These functions are intended for work with <ulink url="&url.wddx;">WDDX</ulink>.</para>
-
- <para>
- Note that all the functions that serialize variables use the first
- element of an array to determine whether the array is to be
- serialized into an array or structure. If the first element has
- string key, then it is serialized into a structure, otherwise,
- into an array.
-
- <example>
- <title>Serializing a single value</title>
- <programlisting role="php">
-<?php
-print wddx_serialize_value("PHP to WDDX packet example", "PHP packet");
-?>
- </programlisting>
- </example></para>
-
- <para>
- This example will produce:
- <informalexample>
- <programlisting role="php">
-<wddxPacket version='0.9'><header comment='PHP packet'/><data>
-<string>PHP to WDDX packet example</string></data></wddxPacket>
- </programlisting>
- </informalexample>
-
- <example>
- <title>Using incremental packets</title>
- <programlisting role="php">
-<?php
-$pi = 3.1415926;
-$packet_id = wddx_packet_start("PHP");
-wddx_add_vars($packet_id, "pi");
-
-/* Suppose $cities came from database */
-$cities = array("Austin", "Novato", "Seattle");
-wddx_add_vars($packet_id, "cities");
-
-$packet = wddx_packet_end($packet_id);
-print $packet;
-?>
- </programlisting>
- </example></para>
-
- <para>
- This example will produce:
-
- <informalexample>
- <programlisting role="php">
-<wddxPacket version='0.9'><header comment='PHP'/><data><struct>
-<var name='pi'><number>3.1415926</number></var><var name='cities'>
-<array length='3'><string>Austin</string><string>Novato</string>
-<string>Seattle</string></array></var></struct></data></wddxPacket>
- </programlisting>
- </informalexample></para>
-
- </partintro>
-
- <refentry id="function.wddx-serialize-value">
- <refnamediv>
- <refname>wddx_serialize_value</refname>
- <refpurpose>Serialize a single value into a WDDX packet</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string
- <function>wddx_serialize_value</function></funcdef>
- <paramdef>mixed <parameter>var</parameter></paramdef>
- <paramdef>string
- <parameter><optional>comment</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- <function>wddx_serialize_value</function> is used to create a
- WDDX packet from a single given value. It takes the value
- contained in <parameter>var</parameter>, and an optional
- <parameter>comment</parameter> string that appears in the packet
- header, and returns the WDDX packet.</para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.wddx-serialize-vars">
- <refnamediv>
- <refname>wddx_serialize_vars</refname>
- <refpurpose>Serialize variables into a WDDX packet</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>wddx_serialize_vars</function></funcdef>
- <paramdef>mixed <parameter>var_name</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- <function>wddx_serialize_vars</function> is used to create a WDDX
- packet with a structure that contains the serialized
- representation of the passed variables.</para>
-
- <para>
- <function>wddx_serialize_vars</function> takes a variable number
- of arguments, each of which can be either a string naming a
- variable or an array containing strings naming the variables or
- another array, etc.</para>
-
- <para>
- <example>
- <title>wddx_serialize_vars example</title>
- <programlisting>
-<?php
-$a = 1;
-$b = 5.5;
-$c = array("blue", "orange", "violet");
-$d = "colors";
-
-$clvars = array("c", "d");
-print wddx_serialize_vars("a", "b", $clvars);
-?>
- </programlisting>
- </example></para>
-
- <para>
- The above example will produce:
- <programlisting>
-<wddxPacket version='0.9'><header/><data><struct><var name='a'><number>1</number></var>
-<var name='b'><number>5.5</number></var><var name='c'><array length='3'>
-<string>blue</string><string>orange</string><string>violet</string></array></var>
-<var name='d'><string>colors</string></var></struct></data></wddxPacket>
- </programlisting></para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.wddx-packet-start">
- <refnamediv>
- <refname>wddx_packet_start</refname>
- <refpurpose>Starts a new WDDX packet with structure inside it</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>wddx_packet_start</function></funcdef>
- <paramdef>string
- <parameter><optional>comment</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- Use <function>wddx_packet_start</function> to start a new WDDX
- packet for incremental addition of variables. It takes an
- optional <parameter>comment</parameter> string and returns a
- packet ID for use in later functions. It automatically creates a
- structure definition inside the packet to contain the variables.</para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.wddx-packet-end">
- <refnamediv>
- <refname>wddx_packet_end</refname>
- <refpurpose>Ends a WDDX packet with the specified ID</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>wddx_packet_end</function></funcdef>
- <paramdef>int <parameter>packet_id</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- <function>wddx_packet_end</function> ends the WDDX packet
- specified by the <parameter>packet_id</parameter> and returns the
- string with the packet.</para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.wddx-add-vars">
- <refnamediv>
- <refname>wddx_add_vars</refname>
- <refpurpose>Ends a WDDX packet with the specified ID</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef><function>wddx_add_vars</function></funcdef>
- <paramdef>int <parameter>packet_id</parameter></paramdef>
- <paramdef>mixed <parameter>name_var</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>...</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- <function>wddx_add_vars</function> is used to serialize passed
- variables and add the result to the packet specified by the
- <parameter>packet_id</parameter>. The variables to be serialized
- are specified in exactly the same way as
- <function>wddx_serialize_vars</function>.</para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.wddx-deserialize">
- <refnamediv>
- <refname>wddx_deserialize</refname>
- <refpurpose>Deserializes a WDDX packet</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>wddx_deserialize</function></funcdef>
- <paramdef>string <parameter>packet</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- <function>wddx_deserialized</function> takes a
- <parameter>packet</parameter> string and deserializes it. It
- returns the result which can be string, number, or array. Note
- that structures are deserialized into associative arrays.</para>
-
- </refsect1>
- </refentry>
- </reference>
-
-<!-- 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
-sgml-parent-document:nil
-sgml-default-dtd-file:"../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
+ <reference id="ref.wddx">
+ <title>WDDX functions</title>
+ <titleabbrev>WDDX</titleabbrev>
+
+ <partintro>
+ <para>
+ Diese Funktionen arbeiten mit <ulink url="&url.wddx;">WDDX</ulink> zusammen.</para>
+
+ <para>
+ Es ist zu beachten, dass alle Funktionen, die Variablen serialisieren,
+ immer das erste Element eines Arrays verwenden um festzustellen ob der
+ Array in einen Array oder eine 'Structure' serialisiert wird.
+ Wenn das erste Element eine String Schlüssel hat, dann wir er in eine
+ 'Structure' serialisiert, andernfalls in einen Array.
+
+ <example>
+ <title>Einen einzelnen String serialisieren</title>
+ <programlisting role="php">
+<?php
+print wddx_serialize_value("PHP to WDDX packet example", "PHP packet");
+?>
+ </programlisting>
+ </example></para>
+
+ <para>
+ dieses Beispiel erzeugt:
+ <informalexample>
+ <programlisting role="php">
+<wddxPacket version='0.9'><header comment='PHP packet'/><data>
+<string>PHP to WDDX packet example</string></data></wddxPacket>
+ </programlisting>
+ </informalexample>
+
+ <example>
+ <title>Die Verwendung von inkrementierenden Paketen</title>
+ <programlisting role="php">
+<?php
+$pi = 3.1415926;
+$packet_id = wddx_packet_start("PHP");
+wddx_add_vars($packet_id, "pi");
+
+/* So tun, als ob $cities aus einer Datenbank kommt ;-) */
+$cities = array("Austin", "Novato", "Seattle");
+wddx_add_vars($packet_id, "cities");
+
+$packet = wddx_packet_end($packet_id);
+print $packet;
+?>
+ </programlisting>
+ </example></para>
+
+ <para>
+ Diese Beispiel wird erzeugen:
+
+ <informalexample>
+ <programlisting role="php">
+<wddxPacket version='0.9'><header comment='PHP'/><data><struct>
+<var name='pi'><number>3.1415926</number></var><var name='cities'>
+<array length='3'><string>Austin</string><string>Novato</string>
+<string>Seattle</string></array></var></struct></data></wddxPacket>
+ </programlisting>
+ </informalexample></para>
+
+ </partintro>
+
+ <refentry id="function.wddx-serialize-value">
+ <refnamediv>
+ <refname>wddx_serialize_value</refname>
+ <refpurpose>Serialisiert einen einzelnen Wert in ein WDDX Packet</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string
+ <function>wddx_serialize_value</function></funcdef>
+ <paramdef>mixed <parameter>wert</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>kommentar</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_serialize_value</function> wird verwendet, um
+ einen einzelnen Wert in ein WDDX Packet zu serialisieren.
+ Übergeben wird der Wert in <parameter>wert</parameter>, und ein
+ optionaler <parameter>kommentar</parameter> der im Header des
+ Packets angegeben wird und gibt das WDDX Paket zurück.</para>
+
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.wddx-serialize-vars">
+ <refnamediv>
+ <refname>wddx_serialize_vars</refname>
+ <refpurpose>Serialisiert variablen in WDDX Pakete</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>wddx_serialize_vars</function></funcdef>
+ <paramdef>mixed <parameter>var_name</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_serialize_vars</function> wird verwendet um ein
+ WDDX Paket mit einer 'Structure', das eine serialsierte Representation
+ der übergebenen Variablen.</para>
+
+ <para>
+ <function>wddx_serialize_vars</function> übernimmt eine variable
+ Zahl an Argumenten. Jedes kann entweder eine String Benennung, eine
+ Variable oder ein Array, der Strings enthält, die die Variablen
+ benennen, oder einen weiteren Array, etc.</para>
+
+ <para>
+ <example>
+ <title>wddx_serialize_vars example</title>
+ <programlisting>
+<?php
+$a = 1;
+$b = 5.5;
+$c = array("blue", "orange", "violet");
+$d = "colors";
+
+$clvars = array("c", "d");
+print wddx_serialize_vars("a", "b", $clvars);
+?>
+ </programlisting>
+ </example></para>
+
+ <para>
+ Das obige Script erzeugt:
+ <programlisting>
+<wddxPacket version='0.9'><header/><data><struct><var name='a'><number>1</number></var>
+<var name='b'><number>5.5</number></var><var name='c'><array length='3'>
+<string>blue</string><string>orange</string><string>violet</string></array></var>
+<var name='d'><string>colors</string></var></struct></data></wddxPacket>
+ </programlisting></para>
+
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.wddx-packet-start">
+ <refnamediv>
+ <refname>wddx_packet_start</refname>
+ <refpurpose>Beginnt ein neue WDDX Packet mit einer 'Structure' darin</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>wddx_packet_start</function></funcdef>
+ <paramdef>string
+ <parameter><optional>kommentar</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_packet_start</function> wird verwendet um ein neues
+ WDDX Paket beginnen um die Variablen nachhinein zu ergänzen.
+ Ein optionaler <parameter>kommentar</parameter> String kann angegeben werden.
+ Es wird eine Packet ID zurückgegeben, die in später in Funktionen
+ verwendet werden kann. Desweiteren wird automatisch 'Structure'
+ Definition erzeugt um die Variablen aufnehmen zu können.</para>
+
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.wddx-packet-end">
+ <refnamediv>
+ <refname>wddx_packet_end</refname>
+ <refpurpose>Schliesst das WDDX Packet mit der angegebenen ID</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>wddx_packet_end</function></funcdef>
+ <paramdef>int <parameter>packet_id</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_packet_end</function> schliesst das WDDX Packet,
+ dass mit mit <parameter>packet_id</parameter> identifiziert wird
+ und gibt einen String mit dem Packet zurück.</para>
+
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.wddx-add-vars">
+ <refnamediv>
+ <refname>wddx_add_vars</refname>
+ <refpurpose>Fügt dem WDDX Packet mit der ID Werte hinzu</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef><function>wddx_add_vars</function></funcdef>
+ <paramdef>int <parameter>packet_id</parameter></paramdef>
+ <paramdef>mixed <parameter>name_var</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_add_vars</function> wird verwendet um die übergebenen
+ Werte zu serialisiern und diese an das Packet anzuhängen, das mit
+ <parameter>packet_id</parameter> identifiziert wird.
+ Die Werteübergabe funktioniert genauso wie bei
+ <function>wddx_serialize_vars</function>.</para>
+
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.wddx-deserialize">
+ <refnamediv>
+ <refname>wddx_deserialize</refname>
+ <refpurpose>Deserialisiert ein WDDX Packet</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>wddx_deserialize</function></funcdef>
+ <paramdef>string <parameter>packet</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+
+ <para>
+ <function>wddx_deserialized</function> übernimmt einen
+ <parameter>packet</parameter> String and deserialisiert es.
+ Es wird entweder ein String, eine Nummer, oder Array als Ergebnis
+ zurückgegeben. 'Structures' werden in assoziative Arrays
+ deserialisiert.</para>
+
+ </refsect1>
+ </refentry>
+ </reference>
+
+<!-- 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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
\ No newline at end of file
- Next message: Egon Schmid: "[PHP-DOC] cvs: phpdoc /de/functions vmailmgr.xml"
- Previous message: Jan Lehnardt: "Re: [PHP-DOC] Error building German manual"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]