cvs: phpdoc-pl /reference/filesystem/functions file.xml
| From: | Leszek Krupinski | 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>
- ¬e.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>
+ ¬e.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>