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 @@ + + GNU Readline + Readline + + + + Die readline 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. + + + Die Homepage des GNU Readline Projekts finden Sie unter + &url.readline;. Das Projekt + wird von Chet Ramey betreut, der außerdem der Autor der Bash ist. + + + + + + readline + Liest eine Zeile + + + Beschreibung + + + string readline + string + prompt + + + + + 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 + readline_add_history der History hinzufügen. + + + <function>readline</function> + +//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()); + + + + + + + + readline_add_history + Fügt eine Zeile zur History hinzu + + + Beschreibung + + + void readline_add_history + + string zeile + + + + Diese Funktion fügt eine Zeile zur Kommandozeilen-History hinzu. + + + + + + + readline_clear_history + Löscht die History + + + Beschreibung + + + bool readline_clear_history + + + + + + Diese Funktion löscht die gesamte Kommandozeilen-History. + + + + + + + readline_completion_function + Registriert eine Vervollständigungsfunktion + + + + Beschreibung + + + bool + readline_completion_function + + string zeile + + + + 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. + + + + + + + readline_info + Liest/Setzt verschiedene interne readline + Variablen + + + Beschreibung + + + mixed readline_info + string + varname + + string + neuerwert + + + + + 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. + + + 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. + + + + + + + readline_list_history + Auflistung der History + + + Beschreibung + + + array readline_list_history + + + + + + Diese Funktion gibt ein Array der gesamten Kommandozeilen-History + zurück. Die Elemente sind mit Ganzzahlen indexiert, beginnend bei + Null. + + + + + + + readline_read_history + Liest die History + + + Beschreibung + + + bool + readline_read_history + + string dateiname + + + + Diese Funktion liest eine Kommando-History aus einer Datei. + + + + + + + + readline_write_history + Schreibt die History + + + Beschreibung + + + bool + readline_write_history + + string dateiname + + + + Diese Funktion schreibt die Kommando-History in eine Datei. + + + + + + + + + + + + + + + + + +