cvs: phpdoc-de /reference/readline configure.xml reference.xml /reference/readline/functions readline-add-history.xml
readline-callback-handler-install.xml readline-callback-handler-remove.xml readline-callback-read-char.xml readline-clear-history.xml
readline-completion-function.xml readline-info.xml readline-list-history.xml readline-on-new-line.xml readline-read-history.xml readline-redisplay.xml
readline-write-history.xml readline.xml /reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml

From:	Carola 'Sammy' Kummert	Date:	Thu, 11 Oct 2007 19:53:00 +0000
Subject:	cvs: phpdoc-de /reference/readline configure.xml reference.xml /reference/readline/functions readline-add-history.xml readline-callback-handler-install.xml readline-callback-handler-remove.xml readline-callback-read-char.xml readline-clear-history.xml readline-completion-function.xml readline-info.xml readline-list-history.xml readline-on-new-line.xml readline-read-history.xml readline-redisplay.xml readline-write-history.xml readline.xml /reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml
Groups:	php.doc.de
Request:	Send a blank email to doc-de+get-2247@lists.php.net to get a copy of this message

sammywg Thu Oct 11 19:53:00 2007 UTC Added files: /phpdoc-de/reference/readline/functions readline-callback-handler-install.xml readline-callback-handler-remove.xml readline-callback-read-char.xml readline-on-new-line.xml readline-redisplay.xml Modified files: /phpdoc-de/reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml /phpdoc-de/reference/readline configure.xml reference.xml /phpdoc-de/reference/readline/functions readline-add-history.xml readline-clear-history.xml readline-completion-function.xml readline-info.xml readline-list-history.xml readline-read-history.xml readline-write-history.xml readline.xml Log: sync to en

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/addcslashes.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/addcslashes.xml diff -u phpdoc-de/reference/strings/functions/addcslashes.xml:1.8 phpdoc-de/reference/strings/functions/addcslashes.xml:1.9 --- phpdoc-de/reference/strings/functions/addcslashes.xml:1.8 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/addcslashes.xml Thu Oct 11 19:52:59 2007 @@ -1,56 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry xml:id="function.addcslashes" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>addcslashes</refname> - <refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran (wie in C)</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>addcslashes</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>charlist</parameter></methodparam> - </methodsynopsis> - <para> - Gibt eine Zeichenkette zurück, in der allen Zeichen, die in - <parameter>charlist</parameter> aufgeführt sind, ein "\" vorangestellt ist. - Falls <parameter>charlist</parameter> die Zeichen <literal>\n</literal>, - <literal>\r</literal> etc. enthält, werden diese im C-Stil - konvertiert, während andere nicht-alphanumerische Zeichen mit einem - ASCII-Wert kleiner als 32 oder höher als 126 in ihre oktale - Repräsentation umgewandelt werden. - </para> - <para> - Seien Sie besonders vorsichtig, wenn Sie Zeichen wie 0, a, b, f, n, r - t oder v escapen möchten. Sie werden zu \0, \a, \b, \f, \n, \r, \t - oder \v gewandelt. - In PHP sind \0 (NULL), \r (Wagenrücklauf), \n (Neue Zeile) und \t - (Tabulator) vordefinierte Escape-Sequenzen, während in C alle der - genannten Zeichen vordefinierte Escape-Sequenzen sind. - </para> - <para> - <parameter>charlist</parameter>-Angaben wie "\0..\37" (oktal) bewirken - ein Escapen aller Zeichen mit einem ASCII-Code zwischen 0 und 31 (dezimal). - <example> - <title><function>addcslashes</function> Beispiel</title> - <programlisting role="php"> -<![CDATA[ -<?php -$escaped = addcslashes($nicht_escaped, "\0..\37!@\177..\377"); -?> -]]> - </programlisting> - </example> - </para> - <para> - Wenn Sie eine Zeichensequenz im charlist-Parameter notieren, - informieren Sie sich darüber, welche Zeichen sich zwischen dem - ersten und dem letzten Zeichen befinden! - <informalexample> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.addcslashes"> + <refnamediv> + <refname>addcslashes</refname> + <refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran (wie in C)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>addcslashes</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>string</type><parameter>charlist</parameter></methodparam> + </methodsynopsis> + <para> + Gibt eine Zeichenkette zurück, in der allen Zeichen, die in + <parameter>charlist</parameter> aufgeführt sind, ein "\" vorangestellt ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die zu escapende Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charlist</parameter></term> + <listitem> + <para> + Eine Liste der zu escapenden Zeichen. Wenn <parameter>charlist</parameter> + Zeichen wie <literal>\n</literal>, <literal>\r</literal> etc. enthält, + werden diese im C-Stil konvertiert, während andere nicht-alphanumerische + Zeichen mit einem ASCII-Wert kleiner als 32 oder höher als 126 in ihre + oktale Repräsentation umgewandelt werden. + </para> + <para> + Wenn Sie eine Zeichensequenz im charlist-Parameter notieren, + informieren Sie sich darüber, welche Zeichen sich zwischen dem + ersten und dem letzten Zeichen befinden! + <informalexample> + <programlisting role="php"> <![CDATA[ <?php echo addcslashes('foo[ ]', 'A..z'); @@ -60,33 +57,77 @@ // Wagenvorlauf-Zeichen etc. ?> ]]> - </programlisting> - </informalexample> - Beachten Sie zudem, dass sofern das erste Zeichen einer Sequenz einen höheren - ASCII-Wert hat als das zweite, keine Sequenz erstellt wird. Nur das erste und - das letzte Zeichen sowie Punkte werden dann escaped. Verwenden Sie die Funktion - <function>ord</function>, um den ASCII-Wert eines Zeichens zu ermitteln. - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + Beachten Sie zudem, dass sofern das erste Zeichen einer Sequenz einen höheren + ASCII-Wert hat als das zweite, keine Sequenz erstellt wird. Nur das erste und + das letzte Zeichen sowie Punkte werden dann escaped. Verwenden Sie die Funktion + <function>ord</function>, um den ASCII-Wert eines Zeichens zu ermitteln. + <informalexample> + <programlisting role="php"> <![CDATA[ <?php echo addcslashes("zoo['.']", 'z..A'); // Ausgabe: \zoo['\.'] ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - Siehe auch - <function>stripcslashes</function>, - <function>stripslashes</function>, - <function>addslashes</function>, - <function>htmlspecialchars</function> und - <function>quotemeta</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + <para> + Seien Sie besonders vorsichtig, wenn Sie Zeichen wie 0, a, b, f, n, r, + t oder v escapen möchten. Sie werden zu \0, \a, \b, \f, \n, \r, \t + oder \v gewandelt. + In PHP sind \0 (NULL), \r (Wagenrücklauf), \n (Neue Zeile) und \t + (Tabulator) vordefinierte Escape-Sequenzen, während in C alle der + genannten Zeichen vordefinierte Escape-Sequenzen sind. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die maskierte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <parameter>charlist</parameter>-Angaben wie "\0..\37" (oktal) bewirken + ein Escapen aller Zeichen mit einem ASCII-Code zwischen 0 und 31 (dezimal). + <example> + <title><function>addcslashes</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$escaped = addcslashes($nicht_escaped, "\0..\37!@\177..\377"); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>stripcslashes</function></member> + <member><function>stripslashes</function></member> + <member><function>addslashes</function></member> + <member><function>htmlspecialchars</function></member> + <member><function>quotemeta</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.addslashes" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>addslashes</refname> - <refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>addslashes</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String (Zeichenkette) zurück, in dem bestimmten - Zeichen ein Backslash "\" voran gestellt wurde. Diese Funktion - ist z.B. für Datenbankabfragen wichtig. Die behandelten Zeichen - sind das einfache und der doppelte Anführungszeichen - (<literal>'</literal> und <literal>"</literal>), der Backslash - selbst (<literal>\</literal>) sowie NUL (das Null-Byte). - </para> - <para> - Ein Beispiel für die Verwendung von <function>addslashes</function> - ist das Schreiben von Daten in eine Datenbank. Möchte man zum Beispiel - einen Namen wie <literal>O'reilly</literal> in ein Datenbankfeld schreiben, - muss er escaped sein. Die meisten Datenbanken verwenden dafür einen - Backslash (<literal>\</literal>), das bedeutet, der String wird in - der Form <literal>O\'reilly</literal> erwartet. Dies ist ausschließlich - für das Einfügen von Daten in eine Datenbank notwendig, der extra - <literal>\</literal> wird nicht wirklich eingefügt. - Hat der php.ini-Parameter <link linkend="ini.magic-quotes-sybase"> - magic_quotes_sybase</link> den Wert <literal>on</literal>, wird - ein <literal>'</literal> anstelle des Backslashes mit einem - weiteren <literal>'</literal> escaped. - </para> - <para> - Die PHP-Direktive <link linkend="ini.magic-quotes-gpc"> - magic_quotes_gpc</link> hat standardmäßig den Wert - <literal>on</literal>, so dass grundsätzlich die Funktion - <function>addslashes</function> auf alle GET-, POST- und COOKIE-Daten - angewendet wird. Verwenden Sie daher die Funktion - <function>addslashes</function> nicht, wenn Strings bereits durch - <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> escaped - wurden, ansonsten erhalten Sie doppeltes Escaping. Um herauszufinden, - ob der Parameter aktiviert ist, verwenden Sie am Einfachsten die - Funktion <function>get_magic_quotes_gpc</function>. - </para> - <para> - <example> - <title>Ein <function>addslashes</function> Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.addslashes"> + <refnamediv> + <refname>addslashes</refname> + <refpurpose>Stellt bestimmten Zeichen eines Strings ein "\" voran</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>addslashes</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen String (Zeichenkette) zurück, in dem bestimmten + Zeichen ein Backslash "\" voran gestellt wurde. Diese Funktion + ist z.B. für Datenbankabfragen wichtig. Die behandelten Zeichen + sind das einfache und der doppelte Anführungszeichen + (<literal>'</literal> und <literal>"</literal>), der Backslash + selbst (<literal>\</literal>) sowie NUL (das Null-Byte). + </para> + <para> + Ein Beispiel für die Verwendung von <function>addslashes</function> + ist das Schreiben von Daten in eine Datenbank. Möchte man zum Beispiel + einen Namen wie <literal>O'reilly</literal> in ein Datenbankfeld schreiben, + muss er escaped sein. Die meisten Datenbanken verwenden dafür einen + Backslash (<literal>\</literal>), das bedeutet, der String wird in + der Form <literal>O\'reilly</literal> erwartet. Dies ist ausschließlich + für das Einfügen von Daten in eine Datenbank notwendig, der extra + <literal>\</literal> wird nicht wirklich eingefügt. + Hat der php.ini-Parameter <link linkend="ini.magic-quotes-sybase"> + magic_quotes_sybase</link> den Wert <literal>on</literal>, wird + ein <literal>'</literal> anstelle des Backslashes mit einem + weiteren <literal>'</literal> escaped. + </para> + <para> + Die PHP-Direktive <link linkend="ini.magic-quotes-gpc"> + magic_quotes_gpc</link> hat standardmäßig den Wert + <literal>on</literal>, so dass grundsätzlich die Funktion + <function>addslashes</function> auf alle GET-, POST- und COOKIE-Daten + angewendet wird. Verwenden Sie daher die Funktion + <function>addslashes</function> nicht, wenn Strings bereits durch + <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> escaped + wurden, ansonsten erhalten Sie doppeltes Escaping. Um herauszufinden, + ob der Parameter aktiviert ist, verwenden Sie am Einfachsten die + Funktion <function>get_magic_quotes_gpc</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die zu maskierende Zeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die maskierte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>addslashes</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Ist dein Name wirklich O'reilly?"; @@ -59,20 +86,26 @@ echo addslashes($str); ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch - <function>stripslashes</function>, - <function>stripcslashes</function>, - <function>addcslashes</function>, - <function>htmlspecialchars</function>, - <function>quotemeta</function> und - <function>get_magic_quotes_gpc</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>stripcslashes</function></member> + <member><function>stripslashes</function></member> + <member><function>addcslashes</function></member> + <member><function>htmlspecialchars</function></member> + <member><function>quotemeta</function></member> + <member><function>get_magic_quotes_gpc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  - - - <refentry xml:id="function.bin2hex" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>bin2hex</refname> - <refpurpose> - Wandelt Binär-Daten in ihre hexadezimale Entsprechung um - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>bin2hex</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Es wird ein ASCII-String mit der hexadezimalen Wiedergabe des - Parameters <parameter>str</parameter> zurück gegeben. Die - Umwandlung geschieht byteweise mit dem höchsten Anteil (4 Bit, - "high-nibble") zuerst. - </para> - <para> - Siehe auch <function>pack</function> und <function>unpack</function>. - </para> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bin2hex"> + <refnamediv> + <refname>bin2hex</refname> + <refpurpose>Wandelt Binär-Daten in ihre hexadezimale Entsprechung um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>bin2hex</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen ASCII-String zurück, der die hexadezimale Wiedergabe des Parameters + <parameter>str</parameter> enthält. Die Umwandlung geschieht byteweise mit + dem höchsten Anteil (4 Bit, "high-nibble") zuerst. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Ein Zeichen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die hexadezimale Darstellung des übergebenen Strings zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>pack</function></member> + <member><function>unpack</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  + + <section xml:id="readline.installation" xmlns="http://docbook.org/ns/docbook"> &reftitle.install; <para> Um diese Funktionen benutzten zu können, müssen Sie die CLI- oder - CGI-Version von PHP mit readline Unterstützung übersetzen. Konfigurieren - Sie PHP mit der Option <option role="configure">--with-readline[=DIR] - </option>. Beabsichtigen Sie als Ersatz für readline libedit zu benutzen, + CGI-Version von PHP mit readline-Unterstützung kompilieren. Konfigurieren + Sie PHP mit der Option <option role="configure">--with-readline[=DIR]</option>. + Beabsichtigen Sie als Ersatz für readline libedit zu benutzen, konfigurieren Sie PHP mit der Option <option role="configure">--with-libedit[=DIR]</option>. </para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/reference.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/readline/reference.xml diff -u phpdoc-de/reference/readline/reference.xml:1.9 phpdoc-de/reference/readline/reference.xml:1.10 --- phpdoc-de/reference/readline/reference.xml:1.9 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/readline/reference.xml Thu Oct 11 19:52:59 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + + <reference xml:id="ref.readline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>GNU Readline</title> @@ -10,35 +10,33 @@ <section xml:id="readline.intro"> &reftitle.intro; <para> - Die <function>readline</function> Funktionen realisieren eine - Schnittstelle zur GNU Readline Bibliothek. Diese Funktionen bieten - die Möglichkeit Kommandozeilen zu editieren. Ein Beispiel für die + Die readline-Funktionen implementieren eine + Schnittstelle zur GNU-Readline-Bibliothek. Diese Funktionen bieten + die Möglichkeit, Kommandozeilen zu editieren. Ein Beispiel für die Anwendung ist die Art und Weise, wie die Bash es erlaubt, die - Pfeiltasten zu benutzen um Schriftzeichen einzufügen oder durch + Pfeiltasten zu benutzen, um Schriftzeichen einzufügen oder durch die Kommando-History zu scrollen. Auf Grund des interaktiven Charakters dieser Bibliothek ist diese beim Programmieren von Webanwendungen von geringem Nutzen, kann aber nützlich sein, wenn - Sie Skripte schreiben, die dafür gedacht sind - <link linkend="features.commandline">PHP von der Kommandozeile - auszuführen</link>. + Sie Skripte schreiben, die dafür gedacht sind, PHP von der + <link linkend="features.commandline">Kommandozeile</link> auszuführen. </para> &note.no-windows.extension; </section> - + <section xml:id="readline.requirements"> &reftitle.required; <para> - Möchten Sie die readline Funktionen nutzen, müssen Sie die libreadline - Bibliothek installieren. Die libreadline Bibliothek finden Sie auf der - Homepage des GNU Readline Projekts unter - <link xlink:href="&url.readline;">&url.readline;</link>. + Möchten Sie die readline Funktionen nutzen, müssen Sie die libreadline-Bibliothek + installieren. Die libreadline-Bibliothek finden Sie auf der Homepage des + GNU-Readline-Projekts unter <link xlink:href="&url.readline;">&url.readline;</link>. Dieses Projekt wird von Chet Ramey betreut, der auch der Author der Bash ist. </para> <para> - Sie können diese Funktionen auch mit der libedit Bibliothek benutzen, + Sie können diese Funktionen auch mit der libedit-Bibliothek benutzen, die einen Ersatz für readline darstellt und nicht der GPL unterliegt. - Die libedit Bibliothek ist BSD lizensiert und steht unter der Adresse + Die libedit-Bibliothek ist BSD-lizensiert und steht unter der Adresse <link xlink:href="&url.libedit;">&url.libedit;</link> zum Download bereit. </para> </section> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/functions/readline-add-history.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/readline/functions/readline-add-history.xml diff -u phpdoc-de/reference/readline/functions/readline-add-history.xml:1.4 phpdoc-de/reference/readline/functions/readline-add-history.xml:1.5 --- phpdoc-de/reference/readline/functions/readline-add-history.xml:1.4 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/readline/functions/readline-add-history.xml Thu Oct 11 19:52:59 2007 @@ -1,25 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - - - <refentry xml:id="function.readline-add-history" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_add_history</refname> - <refpurpose>Fügt eine Zeile zur History hinzu</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>void</type><methodname>readline_add_history</methodname> - <methodparam><type>string</type><parameter>zeile</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion fügt eine Zeile zur Kommandozeilen-History hinzu. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-add-history" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_add_history</refname> + <refpurpose>Fügt eine Zeile zur History hinzu</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>readline_add_history</methodname> + <methodparam><type>string</type><parameter>line</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion fügt eine Zeile zur Kommandozeilen-History hinzu. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>line</parameter></term> + <listitem> + <para> + Die zur History hinzuzufügende Zeile. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> +  - - - - - <refentry xml:id="function.readline-clear-history" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_clear_history</refname> - <refpurpose>Löscht die History</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>readline_clear_history</methodname> - <void/> - </methodsynopsis> - <para> - Diese Funktion löscht die gesamte Kommandozeilen-History. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-clear-history" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_clear_history</refname> + <refpurpose>Löscht die History</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>readline_clear_history</methodname> + <void/> + </methodsynopsis> + <para> + Diese Funktion löscht die gesamte Kommandozeilen-History. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> +  - - <refentry xml:id="function.readline-completion-function" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_completion_function</refname> - <refpurpose>Registriert eine Vervollständigungsfunktion - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>readline_completion_function</methodname> - <methodparam choice="opt"><type>string</type><parameter>Zeile</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion registriert eine Vervollständigungsfunktion. Sie müssen - den Namen einer existierenden Funktion angeben, die einen Teil einer - Kommandozeile akzeptiert und ein Array möglicher Übereinstimmungen - zurückgibt. Das ist die gleiche Art von Funktionalität die Sie haben, wenn - Sie die Tab-Taste benutzen, während Sie mit der Bash arbeiten. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-completion-function" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_completion_function</refname> + <refpurpose>Registriert eine Vervollständigungsfunktion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>readline_completion_function</methodname> + <methodparam><type>callback</type><parameter>function</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion registriert eine Vervollständigungsfunktion. Das ist die + gleiche Art von Funktionalität als wenn Sie die Tab-Taste benutzen, während + Sie mit der Bash arbeiten. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>function</parameter></term> + <listitem> + <para> + Sie müssen den Namen einer existierenden Funktion angeben, die einen Teil + einer Kommandozeile akzeptiert und ein Array möglicher Übereinstimmungen + zurückgibt. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> +  - - - - - <refentry xml:id="function.readline-info" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_info</refname> - <refpurpose>Liest/Setzt verschiedene interne readline - Variablen</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>readline_info</methodname> - <methodparam choice="opt"><type>string</type><parameter>Varname</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>Neuerwert</parameter></methodparam> - </methodsynopsis> - <para> - Wenn diese Funktion ohne Parameter aufgerufen wird, gibt sie - einen Array von Werten für alle Einstellungen zurück, die - readline benutzt. Die Elemente werden durch die folgenden Werte - indiziert: - done, end, erase_empty_line, library_version, line_buffer, mark, - pending_input, point, prompt, readline_name und terminal_name. - </para> - <para> - Wird die Funktion mit einem Parameter aufgerufen, wird der Wert - dieser Einstellung zurückgegeben. - Beim Aufruf mit zwei Parametern wird die Einstellung auf den - angegebenen Wert geändert. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-info" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_info</refname> + <refpurpose>Liest/Setzt verschiedene interne readline-Variablen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>readline_info</methodname> + <methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>newvalue</parameter></methodparam> + </methodsynopsis> + <para> + Liest/Setzt verschiedene interne readline-Variablen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>varname</parameter></term> + <listitem> + <para> + Ein Variablenname. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>newvalue</parameter></term> + <listitem> + <para> + Sofern unterstützt, entspricht der Parameter dem neuen gesetzten Wert. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Wenn diese Funktion ohne Parameter aufgerufen wird, gibt sie + einen Array von Werten für alle Einstellungen zurück, die + readline benutzt. Die Elemente werden durch die folgenden Werte + indiziert: + done, end, erase_empty_line, library_version, line_buffer, mark, + pending_input, point, prompt, readline_name und terminal_name. + </para> + <para> + Wird die Funktion mit einem oder zwei Parametern aufgerufen, wird der + alte Wert zurückgegeben. + </para> + </refsect1> + +</refentry> +  - - - - - <refentry xml:id="function.readline-list-history" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_list_history</refname> - <refpurpose>Auflistung der History</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>array</type><methodname>readline_list_history</methodname> - <void/> - </methodsynopsis> - <para> - Diese Funktion gibt ein Array der gesamten Kommandozeilen-History - zurück. Die Elemente sind numerisch indiziert, beginnend bei - Null. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-list-history" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_list_history</refname> + <refpurpose>Auflistung der History</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>readline_list_history</methodname> + <void/> + </methodsynopsis> + <para> + Gibt die vollständige Kommandozeilen-History zurück. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Diese Funktion gibt ein Array der gesamten Kommandozeilen-History + zurück. Die Elemente sind numerisch indiziert, beginnend bei + Null. + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.readline-read-history" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_read_history</refname> - <refpurpose>Liest die History</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>readline_read_history</methodname> - <methodparam choice="opt"><type>string</type><parameter>Dateiname</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion liest eine Kommando-History aus einer Datei. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-read-history" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_read_history</refname> + <refpurpose>Liest die History</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>readline_read_history</methodname> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion liest eine Kommandozeilen-History aus einer Datei. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Pfad zur Datei, die die Kommandozeilen-History enthält. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.readline-write-history" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline_write_history</refname> - <refpurpose>Schreibt die History</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>readline_write_history</methodname> - <methodparam choice="opt"><type>string</type><parameter>Dateiname</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion schreibt die Kommando-History in eine Datei. - </para> - </refsect1> - </refentry> + + +<refentry xml:id="function.readline-write-history" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline_write_history</refname> + <refpurpose>Schreibt die History</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>readline_write_history</methodname> + <methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion schreibt die Kommandozeilen-History in eine Datei. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Pfad zur Datei, in der gespeichert werden soll. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> +  - - - - - <refentry xml:id="function.readline" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>readline</refname> - <refpurpose>Liest eine Zeile</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>readline</methodname> - <methodparam choice="opt"><type>string</type><parameter>prompt</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion gibt eine einzelne Zeichenkette vom Benutzer - zurück. Sie können eine Zeichenkette angeben, mit dem Sie den - Benutzer zur Eingabe auffordern. Der Zeile die Sie erhalten - fehlt das abschließende Zeichen für einen Zeilenvorschub. Die - Zeile müssen Sie selbst mit Hilfe der Funktion - <function>readline_add_history</function> der History hinzufügen. - </para> - <example> - <title><function>readline</function></title> - <programlisting role="php"> + + +<refentry xml:id="function.readline" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>readline</refname> + <refpurpose>Liest eine Zeile</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>readline</methodname> + <methodparam choice="opt"><type>string</type><parameter>prompt</parameter></methodparam> + </methodsynopsis> + <para> + Liest eine einzelne Zeile vom Benutzer ein. Sie müssen diese Zeile selbst + mittels <function>readline_add_history</function> zur History hinzufügen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>prompt</parameter></term> + <listitem> + <para> + Sie können eine Zeichenkette angeben, mit dem Sie den Benutzer zur + Eingabe auffordern. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine einzelne Zeile des Benutzers zurück. Der Zeile, die Sie erhalten, + fehlt das abschließende Zeichen für einen Zeilenvorschub. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>readline</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -//abfragen von 3 Kommandos vom Benutzer +// Drei Kommandos vom Benutzer abfragen for ($i=0; $i < 3; $i++) { - $zeile = readline("Kommando: "); - readline_add_history($zeile); + $line = readline("Command: "); + readline_add_history($line); } -//anzeigen der History +// History ausgeben print_r(readline_list_history()); -//anzeigen der Variablen +// Variablen ausgeben print_r(readline_info()); ?> ]]> - </programlisting> - </example> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> +   <refentry xml:id="function.readline-callback-handler-install" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>readline_callback_handler_install</refname> <refpurpose>Initialisiert das readline-Callback-Interface und das Terminal, gibt den Prompt aus und springt direkt zurück</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>readline_callback_handler_install</methodname> <methodparam><type>string</type><parameter>prompt</parameter></methodparam> <methodparam><type>callback</type><parameter>callback</parameter></methodparam> </methodsynopsis> <para> Initialisiert ein readline-Callback-Interface, gibt danach den <parameter>prompt</parameter> aus und springt direkt zurück. Der doppelte Aufruf der Funktion ohne Zurücksetzen des verwendeten Callback-Interfaces wird automatisch und in geeigneter Weise das alte Interface überschreiben. </para> <para> Die Callback-Fähigkeiten sind hilfreich, wenn sie mit <function>stream_select</function> kombiniert werden, da dies eine Verschränkung von IO und Benutzereingaben wie mittels <function>readline</function> ermöglicht. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>prompt</parameter></term> <listitem> <para> Die Prompt-Message. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>callback</parameter></term> <listitem> <para> Die <parameter>callback</parameter>-Funktion benötigt einen Parameter; die Benutzereingabe wird zurückgegeben. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="description"> &reftitle.examples; <para> <example> <title>Readline-Callback-Interface-Beispiel</title> <programlisting role="php"> <![CDATA[ <?php function rl_callback($ret) { global $c, $prompting; echo "Sie haben eingegeben: $ret\n"; $c++; if ($c > 10) { $prompting = false; readline_callback_handler_remove(); } else { readline_callback_handler_install("[$c] Geben Sie etwas ein: ", 'rl_callback'); } } $c = 1; $prompting = true; readline_callback_handler_install("[$c] Geben Sie etwas ein: ", 'rl_callback'); while ($prompting) { $w = NULL; $e = NULL; $n = stream_select($r = array(STDIN), $w, $e, null); if ($n && in_array(STDIN, $r)) { // Liest das aktuelle Zeichen und ruft die Callbackfunktion auf, wenn ein // Newline-Zeichen eingegeben wurde readline_callback_read_char(); } } echo "Eingabe deaktiviert. Komplett ausgeführt.\n"; ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>readline_callback_handler_remove</function></member> <member><function>readline_callback_read_char</function></member> <member><function>stream_select</function></member> </simplelist> </para> </refsect1> </refentry>  http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/functions/readline-callback-handler-remove.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/readline/functions/readline-callback-handler-remove.xml +++ phpdoc-de/reference/readline/functions/readline-callback-handler-remove.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry xml:id="function.readline-callback-handler-remove" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>readline_callback_handler_remove</refname> <refpurpose>Entfernt den letztdefinierten Callbackhandler und setzt die Terminalumgebung auf die Ursprungswerte zurück</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>readline_callback_handler_remove</methodname> <void/> </methodsynopsis> <para> Entfernt den letztdefinierten Callbackhandler und setzt die Terminalumgebung auf die Ursprungswerte zurück. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Gibt &true; zurück, wenn der letztdefinierte Callbackhandler zurückgesetzt wurde; falls dieser nicht gefunden wurde, wird &false; zurückgegeben. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> Werfen Sie auch einen Blick auf die Dokumentation der Funktion <function>readline_callback_handler_install</function>, dort finden Sie ein Beispiel zur Verwendung des readline-Callback-Interfaces. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>readline_callback_handler_install</function></member> <member><function>readline_callback_read_char</function></member> </simplelist> </para> </refsect1> </refentry>  http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/functions/readline-callback-read-char.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/readline/functions/readline-callback-read-char.xml +++ phpdoc-de/reference/readline/functions/readline-callback-read-char.xml <?xml version="1.0" encoding="iso-8859-1"?>   <refentry xml:id="function.readline-callback-read-char" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>readline_callback_read_char</refname> <refpurpose>Liest ein Zeichen und informiert das readline-Callback-Interface, wenn die Eingabezeile abgeschlossen wurde</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>readline_callback_read_char</methodname> <void /> </methodsynopsis> <para> Liest ein Zeichen der Benutzereingabe ein. Wenn eine Eingabezeile abgeschlossen ist, informiert diese Funktion das readline-Callback-Interface, das mittels <function>readline_callback_handler_install</function> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.void; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> Werfen Sie auch einen Blick auf die Dokumentation der Funktion <function>readline_callback_handler_install</function>, dort finden Sie ein Beispiel zur Verwendung des readline-Callback-Interfaces. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>readline_callback_handler_install</function></member> <member><function>readline_callback_handler_remove</function></member> </simplelist> </para> </refsect1> </refentry>  http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/functions/readline-on-new-line.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/readline/functions/readline-on-new-line.xml +++ phpdoc-de/reference/readline/functions/readline-on-new-line.xml <?xml version='1.0' encoding='iso-8859-1'?>   <refentry xml:id="function.readline-on-new-line" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>readline_on_new_line</refname> <refpurpose>Informiert readline, dass der Cursor in eine neue Zeile bewegt wurde</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>readline_on_new_line</methodname> <void/> </methodsynopsis> <para> Informiert readline, dass der Cursor in eine neue Zeile bewegt wurde. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.void; </para> </refsect1> </refentry>  http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/readline/functions/readline-redisplay.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/readline/functions/readline-redisplay.xml +++ phpdoc-de/reference/readline/functions/readline-redisplay.xml <?xml version='1.0' encoding='iso-8859-1'?>   <refentry xml:id="function.readline-redisplay" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>readline_redisplay</refname> <refpurpose>Zeichnet den Bildschirm neu</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>readline_redisplay</methodname> <void/> </methodsynopsis> <para> Zeichnet die Eingabezeile neu um den Bildschirm neu aufzubauen. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.void; </para> </refsect1> </refentry>