cvs: phpdoc-pl /reference/filesystem/functions fgets.xml

leszek Sun Feb 8 20:58:42 2004 EDT Modified files: /phpdoc-pl/reference/filesystem/functions fgets.xml Log: [adi] update to rev. 1.11 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fgets.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-pl/reference/filesystem/functions/fgets.xml diff -u phpdoc-pl/reference/filesystem/functions/fgets.xml:1.2 phpdoc-pl/reference/filesystem/functions/fgets.xml:1.3 --- phpdoc-pl/reference/filesystem/functions/fgets.xml:1.2 Wed Apr 17 03:16:09 2002 +++ phpdoc-pl/reference/filesystem/functions/fgets.xml Sun Feb 8 20:58:42 2004 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 --> -<!-- last change to 'fgets' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: adi Status: partial --> -<!-- OLD-Revision: 1.115/EN.1.2 --> +<!-- EN-Revision: 1.11 Maintainer: adi Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.fgets"> <refnamediv> <refname>fgets</refname> @@ -12,12 +10,12 @@ <title>Opis</title> <methodsynopsis> <type>string</type><methodname>fgets</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> + <methodparam><type>resource</type><parameter>uchwyt</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>d³ugo¶æ</parameter></methodparam> - </methodsynopsis> + </methodsynopsis> <para> Zwraca ³añcuch o d³ugo¶ci - 1 bajtów odczytany z pliku wskazanego - przez fp. Czytanie koñczy siê kiedy przeczytano d³ugo¶æ - 1 bajtów + przez <parameter>uchwyt</parameter>. Czytanie koñczy siê kiedy przeczytano d³ugo¶æ - 1 bajtów lub gdy wyst±pi znak nowej linii (jest on do³±czany do zwracanego wyniku) lub gdy wyst±pi znak koñca pliku EOF (którykolwiek przypadek zdarzy siê pierwszy). Je¶li nie zosta³a okre¶lona d³ugo¶æ, @@ -30,36 +28,58 @@ G³ówna pu³apka: </para> <simpara> - Osoby u¿ywaj±ce semantyki 'C' z fgets powinni zauwa¿yæ ró¿nicê - w sposobie zwracania EOF. - </simpara> + Osoby przyzwyczajone do semantyki 'C' powinni zauwa¿yæ ró¿nicê + w sposobie zwracania <literal>EOF</literal> przez <function>fgets</function>. + </simpara> <simpara> Wska¼nik pliku musi byæ poprawny i musi wskazywaæ na plik poprawnie otwarty przez <function>fopen</function>, <function>popen</function> lub <function>fsockopen</function>. - </simpara> + </simpara> <para> Prosty przyk³ad: <example> <title>Czytanie pliku linia po linii</title> <programlisting role="php"> <![CDATA[ -$fd = fopen ("/tmp/inputfile.txt", "r"); -while (!feof ($fd)) { - $buffer = fgets($fd, 4096); +<?php +$uchwyt = fopen ("/tmp/inputfile.txt", "r"); +while (!feof ($uchwyt)) { + $buffer = fgets($uchwyt, 4096); echo $buffer; } -fclose ($fd); +fclose ($uchwyt); +?> ]]> </programlisting> </example> </para> + <note> + <simpara> + Parametr <parameter>d³ugo¶æ</parameter> sta³ siê opcjonalny w PHP 4.2.0 + je¶li zosta³ pominiêty, to powinien przyj±æ warto¶æ 1024. + W PHP 4.3, pominiêcie <parameter>d³ugo¶æ</parameter> powoduje odczytywanie + ze strumienia do chwili osi±gniêcia koñca lini, + Je¶li wiêkszo¶æ lini w pliku jest d³u¿sza od 8KB, du¿o efektywniejsze + jest podanie maksymalnej d³ugo¶ci linii. + </simpara> + </note> + <note> + <simpara> + Funkcja jest binaarnie bezpieczna od PHP 4.3. Poprzednie wersje + nie s± binarnie bezpieczne. + </simpara> + </note> + &note.line-endings; <para> - Patrz tak¿e <function>fread</function>, <function>fopen</function>, - <function>popen</function>, <function>fgetc</function>, - <function>fsockopen</function> i - <function>socket_set_timeout</function>. + Patrz tak¿e: <function>fread</function>, + <function>fgetc</function>, + <function>stream_get_line</function>, + <function>fopen</function>, + <function>popen</function>, + <function>fsockopen</function> i + <function>socket_set_timeout</function>. </para> </refsect1> </refentry>