leszek Fri Nov 9 19:03:08 2001 EDT
Added files:
/phpdoc/pl/functions readline.xml
Log:
finished translation
Index: phpdoc/pl/functions/readline.xml
+++ phpdoc/pl/functions/readline.xml
<?xml encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.readline">
<title>GNU Readline</title>
<titleabbrev>Readline</titleabbrev>
<partintro>
<simpara>
Funkcje <function>readline</function> implementują interfejs do biblioteki
GNU Readline. Funkcje te pozwalają na tworzenie edytowalnych linii
poleceń. Jako przykład może posłużyć Bash, który pozwala na używanie
klawiszy strzałek do poruszania się po wpisanej części polecenia lub
przewijanie histrii. Ze względu na interaktywność tej biblioteki, nie
przyda się ona do pisania aplikacji sieciowych, lecz może być przydatna do
pisania skryptów które mają być uruchamiane z linii poleceń.
</simpara>
<simpara>
Stronę domową projektu GNU Readline można znaleźć pod adresem
<ulink url="&url.readline;">&url.readline;</ulink>. Zajmuje się nią Chet
Ramey, który jest także autorem Basha.
</simpara>
</partintro>
<refentry id="function.readline">
<refnamediv>
<refname>readline</refname>
<refpurpose>Czyta linię</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>readline</function></funcdef>
<paramdef>string
<parameter><optional>prompt</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta zwraca pojedyńczy string pobrany od użytkownika. Jako parametr
funkcji można podać string zawierający prompt (znak zachęty) który będzie
wyświetlony. Zwracany string ma usunięty z końca znak nowego wiersza.
Musisz dodać do linię do historii ręcznie używając
<function>readline_add_history</function>.
</para>
<example>
<title><function>readline</function></title>
<programlisting role="php">
//pobierz 3 komendy od użytkownika
for ($i=0; $i < 3; $i++) {
$line = readline ("Komenda: ");
readline_add_history ($line);
}
//zrzuć historię
print_r (readline_list_history());
//zrzuć zmienne
print_r (readline_info());
</programlisting>
</example>
</refsect1>
</refentry>
<refentry id="function.readline-add-history">
<refnamediv>
<refname>readline_add_history</refname>
<refpurpose>Dodaje linię do historii</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>readline_add_history</function></funcdef>
<paramdef>string <parameter>linia</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta dodaje linię do historii linii poleceń.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-clear-history">
<refnamediv>
<refname>readline_clear_history</refname>
<refpurpose>Czyści historię</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>readline_clear_history</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta czyści całą historię linii poleceń.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-completion-function">
<refnamediv>
<refname>readline_completion_function</refname>
<refpurpose>Rejestruje funkcję dopełniania</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool
<function>readline_completion_function</function>
</funcdef>
<paramdef>string <parameter>linia</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta rejestruje funkcję dopełniania. Musisz podać nazwę istniejącej
funkcji, która przyjmuje jako parametr częściowo wypełnioną linię i
zwraca tablicę możliwych dopełnień. Jest to efekt który można
zaobserwować wciskając klawisz TAB używając Basha.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-info">
<refnamediv>
<refname>readline_info</refname>
<refpurpose>Pobiera/ustawia różne wewnętrzne zmienne readline'a</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>readline_info</function></funcdef>
<paramdef>string
<parameter><optional>nazwa_zmiennej</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>nowa_wartość</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Jeśli funkcja zostanie wywołana bez parametrów, to zwrócona zostanie
tablica z wartościami wszystkich ustawień biblioteki readline. Elementy
tej tablicy będą miały takie indeksy: done, end, erase_empty_line,
library_version, line_buffer, mark, pending_input, point, prompt,
readline_name, i terminal_name.
</para>
<para>
Jeśli zostanie wywołana z jednym parametrem, to zwrócona zostanie wartość
ustawienia podanego jako parametr. Jeśli zostanie wywołana z dwoma
paremetrami, zmienione zostanie podane ustawienie.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-list-history">
<refnamediv>
<refname>readline_list_history</refname>
<refpurpose>Zwraca listę historii</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>readline_list_history</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta zwraca tablicę zawierającą całą historię linii poleceń.
Elementy są indeksowane przez liczby całkowite poczynając od zera.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-read-history">
<refnamediv>
<refname>readline_read_history</refname>
<refpurpose>Czyta historię</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool
<function>readline_read_history</function>
</funcdef>
<paramdef>string <parameter>nazwa_pliku</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta czyta historię poleceń z pliku.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-write-history">
<refnamediv>
<refname>readline_write_history</refname>
<refpurpose>Zapisuje historię</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool
<function>readline_write_history</function>
</funcdef>
<paramdef>string <parameter>nazwa_pliku</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkcja ta zapisuje historię poleceń do pliku.
</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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
