cvs: phpdoc-de /reference/url/functions base64-decode.xml base64-encode.xml get-headers.xml get-meta-tags.xml

From: Date: Sat, 14 Apr 2007 23:12:03 +0000
Subject: cvs: phpdoc-de /reference/url/functions base64-decode.xml base64-encode.xml get-headers.xml get-meta-tags.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2153@lists.php.net to get a copy of this message
sammywg Sat Apr 14 23:12:03 2007 UTC Modified files: /phpdoc-de/reference/url/functions base64-decode.xml base64-encode.xml get-headers.xml get-meta-tags.xml Log: update to current english versions

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/base64-decode.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/url/functions/base64-decode.xml diff -u phpdoc-de/reference/url/functions/base64-decode.xml:1.4 phpdoc-de/reference/url/functions/base64-decode.xml:1.5 --- phpdoc-de/reference/url/functions/base64-decode.xml:1.4 Wed Jun 7 17:36:56 2006 +++ phpdoc-de/reference/url/functions/base64-decode.xml Sat Apr 14 23:12:03 2007 @@ -1,52 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> <!-- splitted from ./de/functions/url.xml, last change in rev 1.2 --> - <refentry id="function.base64-decode"> - <refnamediv> - <refname>base64_decode</refname> - <refpurpose>DekodiertMIME base64-kodierte Daten</refpurpose> - </refnamediv> - - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>base64_decode</methodname> - <methodparam><type>string</type><parameter>encoded_data</parameter></methodparam> - </methodsynopsis> - <para> - <function>base64_decode</function> dekodiert - <parameter>encoded_data</parameter> und gibt die Originaldaten oder im - Fehlerfall &false; zurück. Die zurückgegebenen Daten können binär sein. - </para> - <para> - <example> - <title><function>base64_decode</function>-Beispiel</title> - <programlisting role="php"> +<refentry id="function.base64-decode"> + <refnamediv> + <refname>base64_decode</refname> + <refpurpose>DekodiertMIME base64-kodierte Daten</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>base64_decode</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam> + </methodsynopsis> + <para> + Dekodiert base64-kodierte Daten, die in <parameter>data</parameter> + übergeben wurden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + Die zu dekodierenden Daten. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>strict</parameter></term> + <listitem> + <para> + Gibt &false; zurück, wenn der Input Leerzeichen oder einen anderen + Separator enthält. + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Originaldaten oder im Fehlerfall &false; zurück. Die zurückgegebenen + Daten können in Binärform vorliegen. + </para> + </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.2.0</entry> + <entry><parameter>strict</parameter>-Parameter hinzugefügt</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>base64_decode</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$str = 'VGhpcyBpcyBhbiBlbmNvZGVkIHN0cmluZw=='; +$str = 'RGllcyBpc3QgZWluIHp1IGtvZGllcmVuZGVyIFN0cmluZw=='; echo base64_decode($str); ?> ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -This is an encoded string +Dies ist ein zu kodierender String ]]> - </screen> - </example> - </para> - <para> - Siehe auch - <function>base64_encode</function> und - <ulink url="&url.rfc;2045">RFC 2045</ulink> Kapitel 6.8. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>base64_encode</function></member> + <member><ulink url="&url.rfc;2045">RFC 2045</ulink> Kapitel 6.8</member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/base64-encode.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/url/functions/base64-encode.xml diff -u phpdoc-de/reference/url/functions/base64-encode.xml:1.4 phpdoc-de/reference/url/functions/base64-encode.xml:1.5 --- phpdoc-de/reference/url/functions/base64-encode.xml:1.4 Wed Jun 7 17:36:56 2006 +++ phpdoc-de/reference/url/functions/base64-encode.xml Sat Apr 14 23:12:03 2007 @@ -1,59 +1,91 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/url.xml, last change in rev 1.2 --> - <refentry id="function.base64-encode"> - <refnamediv> - <refname>base64_encode</refname> - <refpurpose>Kodiert Daten MIME base64</refpurpose> - </refnamediv> - - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>base64_encode</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - </methodsynopsis> - <para> - <function>base64_encode</function> gibt <parameter>data</parameter> in - base64-kodierter Form zurück. Diese Form des Encodings wurde entworfen, um - Binärdaten unbeschädigt mittels Technologien wie E-Mail übertragen zu - können, die nicht korrekt mit 8-Bit-Zeichen umgehen. - </para> - <para> - Base64-kodierte Daten benötigen ungefähr 33% mehr Speicher als - die Originaldaten. - </para> - <para> - <example> - <title><function>base64_encode</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> +<refentry id="function.base64-encode"> + <refnamediv> + <refname>base64_encode</refname> + <refpurpose>Kodiert Daten MIME base64</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>base64_encode</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + </methodsynopsis> + <para> + Kodiert den übergebenene Parameter <parameter>data</parameter> mittels base64. + </para> + <para> + Diese Form des Encodings wurde entworfen, um Binärdaten unbeschädigt mittels + Technologien wie E-Mail übertragen zu können, die nicht korrekt mit + 8-Bit-Zeichen umgehen. + </para> + <para> + Base64-kodierte Daten benötigen ungefähr 33% mehr Speicher als die + Originaldaten. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + Die zu kodierenden Daten. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die kodierten Daten in Stringform. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>base64_encode</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$str = 'This is an encoded string'; +$str = 'Dies ist ein zu kodierender String'; echo base64_encode($str); ?> ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -VGhpcyBpcyBhbiBlbmNvZGVkIHN0cmluZw== +RGllcyBpc3QgZWluIHp1IGtvZGllcmVuZGVyIFN0cmluZw== ]]> - </screen> - </example> - </para> - <para> - Siehe auch - <function>base64_decode</function>, - <function>chunk_split</function>, - <function>convert_uuencode</function> und - <ulink url="&url.rfc;2045">RFC 2045</ulink> Kapitel 6.8. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>base64_decode</function></member> + <member><function>chunk_split</function></member> + <member><function>convert_uuencode</function></member> + <member><ulink url="&url.rfc;2045">RFC 2045</ulink> section 6.8</member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/get-headers.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/url/functions/get-headers.xml diff -u phpdoc-de/reference/url/functions/get-headers.xml:1.2 phpdoc-de/reference/url/functions/get-headers.xml:1.3 --- phpdoc-de/reference/url/functions/get-headers.xml:1.2 Thu Aug 10 19:53:42 2006 +++ phpdoc-de/reference/url/functions/get-headers.xml Sat Apr 14 23:12:03 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> <refentry id="function.get-headers"> <refnamediv> <refname>get_headers</refname> @@ -18,21 +18,71 @@ <para> <function>get_headers</function> gibt ein Array zurück, das die vom Server in seiner Antwort (Response) auf eine HTTP-Anfrage gesendeten Header enthält. - Gibt im Fehlerfall &false; zurück, und ein Error des Levels - <constant>E_WARNING</constant> wird ausgegeben. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Hat der optionale Parameter <parameter>format</parameter> den Wert 1, parst - <function>get_headers</function> die Antwort (Response) und setzt die - Arraykeys. + <variablelist> + <varlistentry> + <term><parameter>url</parameter></term> + <listitem> + <para> + Der Ziel-URL. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Wenn der optionale Parameter <parameter>format</parameter> auf 1 gesetzt + wird, parst <function>get_headers</function> die Serverantwort und + setzt entsprechende Arrayschlüssel. + </para> + </listitem> + </varlistentry> + </variablelist> </para> - <note> - <para> - Seit PHP 5.1.3 verwendet diese Funktion den Standard Stream Kontext, der - mittels der Funktion <function>stream_context_get_default</function> - gesetzt/geändert werden kann. - </para> - </note> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein indexbasiertes oder ein assoziatives Array zurück, das die + übermittelten Header enthält. Im Fehlerfall wird &false; zurückgegeben. + </para> + </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.3</entry> + <entry> + Die Funktion verwendet nun den Standard-Streamkontext, der mittels + <function>stream_context_get_default</function> gesetzt respektive + verändert werden kann. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>get_headers</function>-Beispiel</title> @@ -80,6 +130,7 @@ </example> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/url/functions/get-meta-tags.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/url/functions/get-meta-tags.xml diff -u phpdoc-de/reference/url/functions/get-meta-tags.xml:1.2 phpdoc-de/reference/url/functions/get-meta-tags.xml:1.3 --- phpdoc-de/reference/url/functions/get-meta-tags.xml:1.2 Wed Jun 7 17:36:56 2006 +++ phpdoc-de/reference/url/functions/get-meta-tags.xml Sat Apr 14 23:12:03 2007 @@ -1,93 +1,150 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> <!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry id="function.get-meta-tags"> - <refnamediv> - <refname>get_meta_tags</refname> - <refpurpose>Liest alle content-Attribute der Meta-Tags einer Datei aus und +<refentry id="function.get-meta-tags"> + <refnamediv> + <refname>get_meta_tags</refname> + <refpurpose>Liest alle content-Attribute der Meta-Tags einer Datei aus und gibt ein Array zurück</refpurpose> - </refnamediv> + </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_meta_tags</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter></methodparam> - </methodsynopsis> - <para> - Öffnet <parameter>filename</parameter> und untersucht die Datei Zeile - für Zeile auf das Vorkommen von &lt;meta&gt;-Tags. Es kann eine lokale - Datei oder ein <acronym>URL</acronym> übergeben werden. Das Parsen wird - beim ersten Auftreten von <literal>&lt;/head&gt;</literal> beendet. - </para> - <para> - Setzen Sie <parameter>use_include_path</parameter> auf &true;, versucht PHP, - das angegebene File innerhalb des mittels <link - linkend="ini.include-path">include_path</link> angegebenen standardmäßigen - Include-Pfades zu finden und zu öffnen. Diese Option kann nur auf lokale - Dateien angewendet werden, nicht auf URLs. - </para> - <para> - <example> - <title>Was <function>get_meta_tags</function> untersucht</title> - <programlisting role="html"> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_meta_tags</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter></methodparam> + </methodsynopsis> + <para> + Öffnet <parameter>filename</parameter> und untersucht die Datei Zeile für + Zeile auf das Vorkommen von &lt;meta&gt;-Tags. Das Parsen wird beim ersten + Auftreten von <literal>&lt;/head&gt;</literal> beendet. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Der Pfad zur HTML-Datei im Stringformat. Die Datei kann lokal oder als + ein <acronym>URL</acronym> vorliegen. + </para> + <para> + <example> + <title>Was <function>get_meta_tags</function> parst</title> + <programlisting role="html"> <![CDATA[ <meta name="author" content="name"> <meta name="keywords" content="php documentation"> <meta name="DESCRIPTION" content="a php manual"> <meta name="geo.position" content="49.33;-86.59"> -</head> <!-- das Parsen wird hier beendet --> +</head> <!-- parsing stops here --> ]]> - </programlisting> - </example> - (Achten Sie besonders auf die Zeilenende-Zeichen - PHP verwendet eine native - Funktion, um die Eingabe zu analysieren, daher können Mac-Dateien nicht auf - einem Unix untersucht werden.) - </para> - <para> - Der Wert des name-Attributs wird der Schlüssel, der Wert des - content-Attributs der zugeordnete Wert innerhalb des zurückgegebenen - Arrays, so dass sie einfach die normalen Array-Funktionen nutzen können, - um das Array zu durchlaufen oder auf einzelne Werte zuzugreifen. - Sonderzeichen im Wert des name-Attributs werden durch '_' ersetzt, der Rest - wird in Kleinbuchstaben umgewandelt. Haben zwei Meta-Tags den gleichen - Namen, wird nur der letzte zurückgegeben. - </para> - <para> - <example> - <title>Was <function>get_meta_tags</function> zurückgibt</title> - <programlisting role="php"> + </programlisting> + </example> + (Geben Sie auf die Zeilenenden acht - PHP verwendet eine native Funktion, + um den Input zu parsen, daher werden Mac-Dateien auf einem Unix-System + zu Fehlern führen.) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>use_include_path</parameter></term> + <listitem> + <para> + Ist <parameter>use_include_path</parameter> auf &true; gesetzt, wird PHP + immer versuchen, die gesuchte Datei innerhalb des + Standard-Include-Pfades, wie er via <link + linkend="ini.include-path">include_path</link>-Direktive angegeben ist, + zu finden. Diese angabe wird nur für lokale Dateien nicht jedoch für URLs + verwendet. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein Array mit allen geparsten Metatags zurück. + </para> + <para> + Der Wert des name-Attributs wird dabei zum Schlüssel, der Wert des + content-Attributs wird der Wert des zurückgegebenen Arrays, so dass Sie + einfach die Standard-Arrayfunktionen verwenden können, um durch das gesamte + Array zu traversieren oder auf einzelne Werte davon zuzugreifen. + Sonderzeichen im Wert des name-Attributs werden mit '_' ersetzt, alle anderen + Zeichen werden in Kleinbuchstaben konvertiert. Haben zwei Metatags den + gleichen Namen, wird nur der letzte zurückgegeben. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.0.5</entry> + <entry> + Support für ungequotete HTML-Attribute hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Was <function>get_meta_tags</function> zurückgibt</title> + <programlisting role="php"> <![CDATA[ <?php -// Angenommen, die o.g. Tags kommen von www.example.com +// Angenommen die genannten Tags stuenden auf www.example.com $tags = get_meta_tags('http://www.example.com/'); -// Beachten Sie, dass alle Keys jetzt klein geschrieben werden -// und dass . durch _ im Schluesselnamen ersetzt wird +// Beachten Sie, dass alle Keys kleingeschrieben werden +// und dass . im Schluessel durch _ ersetzt wird. echo $tags['author']; // name echo $tags['keywords']; // php documentation echo $tags['description']; // a php manual echo $tags['geo_position']; // 49.33;-86.59 ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Seit PHP 4.0.5 unterstützt <function>get_meta_tags</function> auch - HTML-Attribute, die nicht in Anführungszeichen notiert wurden. - </para> - </note> - <para> - Siehe auch - <function>htmlentities</function> und - <function>urlencode</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>htmlentities</function></member> + <member><function>urlencode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.de (#2153) next »