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

From: Date: Wed, 07 Apr 2004 01:03:37 +0000
Subject: cvs: phpdoc-pl /reference/filesystem/functions file.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-315@lists.php.net to get a copy of this message
leszek Tue Apr 6 21:03:37 2004 EDT Modified files: /phpdoc-pl/reference/filesystem/functions file.xml Log: [adi] update to rev. 1.15 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/file.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-pl/reference/filesystem/functions/file.xml diff -u phpdoc-pl/reference/filesystem/functions/file.xml:1.2 phpdoc-pl/reference/filesystem/functions/file.xml:1.3 --- phpdoc-pl/reference/filesystem/functions/file.xml:1.2 Wed Apr 17 03:16:09 2002 +++ phpdoc-pl/reference/filesystem/functions/file.xml Tue Apr 6 21:03:37 2004 @@ -1,11 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 --> -<!-- last change to 'file' 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.15 Maintainer: adi Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.file"> <refnamediv> - <refname>file</refname> + <refname>file</refname> <refpurpose>Czyta ca³± zawarto¶æ pliku do tablicy</refpurpose> </refnamediv> <refsect1> @@ -14,22 +12,18 @@ <type>array</type><methodname>file</methodname> <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>u¿yj_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>kontekst</parameter></methodparam> </methodsynopsis> - <para> + <para> Dzia³a identycznie jak <function>readfile</function>, tylko ¿e <function>file</function> zwraca plik w tablicy. Ka¿dy element tablicy odpowiada linii w pliku. Elementy tablicy zawieraj± - znak nowej linii. + znak nowej linii. W przypadku b³êdu, <function>file</function> + zwraca &false;. </para> - <note> - <para> - Ka¿da linia w wynikowej tabeli zawiera znak nowej lini, je¶li chcesz - siê ich pozbyæ to musisz u¿yæ <function>trim</function>. - </para> - </note> <para> - Mo¿esz u¿yæ opcjonalnego 2 parametru i ustawiæ go na "1", je¶li - chcesz szukaæ pliku tak¿e w + Mo¿esz u¿yæ opcjonalnego parametru <parameter>use_include_path</parameter> i + ustawiæ go na "1", je¶li chcesz szukaæ pliku tak¿e w <link linkend="ini.include-path">include_path</link>. </para> <para> @@ -37,25 +31,50 @@ <programlisting role="php"> <![CDATA[ <?php -// pobiera stronê WWW do tablicy i wy¶wietla j± -$fcontents = file ('http://www.php.net/'); -while (list ($line_num, $line) = each ($fcontents)) { - echo "<b>Linia $line_num:</b>; ", htmlspecialchars ($line), "<br>\n"; +// Pobierz plik do tablicy. W tym przyk³adzie poprzez HTTP pobierzemy +// ¼ród³o HTML z URL +$lines = file('http://www.example.com/'); +// Za pomoc± pêtli przegl±damy nasz± tablicê i pokazujemy ¼ród³o strony w postaci +// ¼ród³a HTML oraz numery linii. + foreach ($lines as $line_num => $line) { + echo "Linia #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n"; } -// pobiera stronê WWW i zapisuje do ³añcucha -$fcontents = join ('', file ('http://www.php.net/')); +// Kolejny przyklad pozwala pobraæ stronê i umie¶ciæ j± w ³añcuchu znaków Zobacz tak¿e file_get_contents(). +$html = implode ('', file ('http://www.example.com/')); ?> ]]> </programlisting> </informalexample> </para> - &note.not-bin-safe; - &tip.fopen-wrapper; + &tip.fopen-wrapper; + <note> + <para> + Ka¿da linia w wynikowej tabeli bêdzie zawieraæ znak(i) koñca linii, + je¶li nie chcesz ich musisz uzyæ <function>rtrim</function>. + </para> + </note> + &note.line-endings; + <note> + <para> + W PHP 4.3.0 mo¿esz u¿yæ <function>file_get_contents</function> aby + zwróciæ zawarto¶æ pliku do ³añcucha. + </para> + <para> + W PHP 4.3.0 <function>file</function> sta³ siê binarnie bezpieczny. + </para> + </note> + <note> + <simpara> + Obs³uga kontekstu zosta³a dodana w <literal>PHP 5.0.0</literal>. + </simpara> + </note> + &warn.ssl-non-standard; <para> - Patrz tak¿e <function>readfile</function>, - <function>fopen</function>, <function>fsockopen</function> i - <function>popen</function>. + Patrz tak¿e: <function>readfile</function>, + <function>fopen</function>, <function>fsockopen</function>, <function>popen</function>, + <function>file_get_contents</function> + i <function>include</function>. </para> </refsect1> </refentry>

« previous php.doc.pl (#315) next »