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
-->
