tom Sat Jul 14 03:50:50 2001 EDT
Modified files:
/phpdoc/de/functions readline.xml
Log:
Translation from Friedhelm Betz
Index: phpdoc/de/functions/readline.xml
diff -u /dev/null phpdoc/de/functions/readline.xml:1.4
--- /dev/null Sat Jul 14 03:50:50 2001
+++ phpdoc/de/functions/readline.xml Sat Jul 14 03:50:49 2001
@@ -0,0 +1,263 @@
+ <reference id="ref.readline">
+ <title>GNU Readline</title>
+ <titleabbrev>Readline</titleabbrev>
+
+ <partintro>
+ <simpara>
+ 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
+ Anwendung ist die Art und Weise, wie die Bash es erlaubt, die
+ Pfeiltasten zu benutzen um Schriftzeichen einzuf�gen oder durch
+ die Kommando-History zu scrollen. Auf Grund des interaktiven
+ Charakters dieser Bibliothek ist diese von geringem Nutzen beim
+ Programmieren von Webanwendungen, kann aber n�tzlich sein, wenn
+ Sie Skripte schreiben, die daf�r gedacht sind in einer Shell
+ abzulaufen.
+ </simpara>
+ <simpara>
+ Die Homepage des GNU Readline Projekts finden Sie unter
+ <ulink url="&url.readline;">&url.readline;</ulink>. Das Projekt
+ wird von Chet Ramey betreut, der au�erdem der Autor der Bash ist.
+ </simpara>
+ </partintro>
+
+ <refentry id="function.readline">
+ <refnamediv>
+ <refname>readline</refname>
+ <refpurpose>Liest eine Zeile</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>readline</function></funcdef>
+ <paramdef>string
+ <parameter><optional>prompt</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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">
+//abfragen von 3 Kommandos vom Benutzer
+for ($i=0; $i < 3; $i++) {
+ $zeile = readline ("Kommando: ");
+ readline_add_history ($line);
+}
+
+//anzeigen der History
+print_r (readline_list_history());
+
+//anzeigen der Variablen
+print_r (readline_info());
+ </programlisting>
+ </example>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.readline-add-history">
+ <refnamediv>
+ <refname>readline_add_history</refname>
+ <refpurpose>F�gt eine Zeile zur History hinzu</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>readline_add_history</function>
+ </funcdef>
+ <paramdef>string <parameter>zeile</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion f�gt eine Zeile zur Kommandozeilen-History hinzu.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.readline-clear-history">
+ <refnamediv>
+ <refname>readline_clear_history</refname>
+ <refpurpose>L�scht die History</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>readline_clear_history</function>
+ </funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion l�scht die gesamte Kommandozeilen-History.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.readline-completion-function">
+ <refnamediv>
+ <refname>readline_completion_function</refname>
+ <refpurpose>Registriert eine Vervollst�ndigungsfunktion
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool
+ <function>readline_completion_function</function>
+ </funcdef>
+ <paramdef>string <parameter>zeile</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 id="function.readline-info">
+ <refnamediv>
+ <refname>readline_info</refname>
+ <refpurpose>Liest/Setzt verschiedene interne readline
+ Variablen</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>readline_info</function></funcdef>
+ <paramdef>string
+ <parameter><optional>varname</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>neuerwert</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 id="function.readline-list-history">
+ <refnamediv>
+ <refname>readline_list_history</refname>
+ <refpurpose>Auflistung der History</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>readline_list_history</function>
+ </funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt ein Array der gesamten Kommandozeilen-History
+ zur�ck. Die Elemente sind mit Ganzzahlen indexiert, beginnend bei
+ Null.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.readline-read-history">
+ <refnamediv>
+ <refname>readline_read_history</refname>
+ <refpurpose>Liest die History</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool
+ <function>readline_read_history</function>
+ </funcdef>
+ <paramdef>string <parameter>dateiname</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion liest eine Kommando-History aus einer Datei.
+ </para>
+ </refsect1>
+ </refentry>
+
+
+ <refentry id="function.readline-write-history">
+ <refnamediv>
+ <refname>readline_write_history</refname>
+ <refpurpose>Schreibt die History</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool
+ <function>readline_write_history</function>
+ </funcdef>
+ <paramdef>string <parameter>dateiname</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion schreibt die Kommando-History in eine Datei.
+ </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:
+-->
+
+
+
+
+
+
+
+
+
+
+
