cvs: phpdoc-pl /reference/filesystem/functions fread.xml
| From: | Leszek Krupinski | Date: | Mon, 07 Mar 2005 01:04:40 +0000 |
| Subject: | cvs: phpdoc-pl /reference/filesystem/functions fread.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-505@lists.php.net to get a copy of this message | ||
leszek Sun Mar 6 20:04:40 2005 EDT
Modified files:
/phpdoc-pl/reference/filesystem/functions fread.xml
Log:
[adi] update to rev 1.16
http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fread.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-pl/reference/filesystem/functions/fread.xml
diff -u phpdoc-pl/reference/filesystem/functions/fread.xml:1.3
phpdoc-pl/reference/filesystem/functions/fread.xml:1.4
--- phpdoc-pl/reference/filesystem/functions/fread.xml:1.3 Fri May 17 09:50:49 2002
+++ phpdoc-pl/reference/filesystem/functions/fread.xml Sun Mar 6 20:04:40 2005
@@ -1,59 +1,94 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 -->
-<!-- last change to 'fread' in en/ tree in rev 1.25 -->
-<!-- EN-Revision: 1.2 Maintainer: adi Status: partial -->
-<!-- OLD-Revision: 1.115/EN.1.25 -->
- <refentry id="function.fread">
+<!-- EN-Revision: 1.16 Maintainer: adi Status: ready -->
+<!-- $Revision: 1.4 $ -->
+ <refentry id="function.fread">
<refnamediv>
<refname>fread</refname>
- <refpurpose>Odczyt plików binarnie bezpieczny</refpurpose>
+ <refpurpose>Odczyt pliku binarnie bezpieczy</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
<type>string</type><methodname>fread</methodname>
-
<methodparam><type>int</type><parameter>fp</parameter></methodparam>
+
<methodparam><type>resource</type><parameter>uchwyt</parameter></methodparam>
<methodparam><type>int</type><parameter>d³ugo¶æ</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>fread</function> odczytuje do
<parameter>d³ugo¶æ</parameter> bajtów ze wska¼nika pliku
- <parameter>fp</parameter>. Czytanie koñczy siê gdy
- odczytano ju¿ <parameter>d³ugo¶æ</parameter> bajtów
- lub osi±gniêto EOF, cokolwiek nast±pi pierwsze.
- </simpara>
+ okre¶lonego przez <parameter>uchwyt</parameter>. Czytanie koñczy siê
+ gdy odczytano <parameter>d³ugo¶æ</parameter> bajtów, osi±gniêty
+ zosta³ koniec pliku (EOF) lub (dla sieciowych strumieni), kiedy pakiet
+ stanie siê dostêpny, cokolwiek nast±pi pierwsze.
+ </simpara>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
+<?php
// pobierz zawarto¶æ pliku do ³añcucha
-$filename = "/usr/local/something.txt";
-$fd = fopen ($filename, "r");
-$contents = fread ($fd, filesize ($filename));
-fclose ($fd);
+$nazwa_pliku = "/usr/local/jakis.txt";
+$uchwyt = fopen($nazwa_pliku, "r");
+$tresc = fread($uchwyt, filesize($nazwa_pliku));
+fclose($uchwyt);
+?>
]]>
</programlisting>
</informalexample>
</para>
- <note>
+ <warning>
<para>
- W systemach, które rozró¿niaj± pliki na binarne i tekstowe
- (np. Windows) plik musi zostaæ otworzony z 'b' w³±czonym do
- parametru tryb funkcji <function>fopen</function>.
+ W systemach, które rozró¿niaj± pliki binarne i tekstowe
+ (np. Windows) plik musi zostaæ otworzony z 'b' do³±czonym do
+ parametru tryb <function>fopen</function>.
</para>
- </note>
+ </warning>
+ <para>
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$nazwa_pliku = "c:\\pliki\\jakisobrazek.gif";
+$uchwyt = fopen($nazwa_pliku, "rb");
+$tresc = fread($uchwyt, filesize($nazwa_pliku));
+fclose($uchwyt);
+?>
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+
+ <warning>
+ <para>
+ Kiedy nastêpuje odczyt z sieciowych strumieni lub potoków, takich jak te zwrócone
+ gdy odczytujesz <link linkend="features.remote-files">zdalne pliki</link>
lub z
+ <function>popen</function> i <function>fsockopen</function>, odczyt
zakoñczy siê
+ po tym jak pakiet jest dostêpny. To znaczy, ¿e powiniene¶ gromadziæ dane razem
+ z kawa³ków jak pokazano na poni¿szym przyk³adzie.
+ </para>
+ </warning>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
-$filename = "c:\\files\\somepic.gif";
-$fd = fopen ($filename, "rb");
-$contents = fread ($fd, filesize ($filename));
-fclose ($fd);
+<?php
+$uchwyt = fopen("http://www.przykladowy.com/", "rb");
+$tresc = '';
+while (!feof($uchwyt)) {
+ $tresc .= fread($uchwyt, 8192);
+}
+fclose($uchwyt);
+?>
]]>
</programlisting>
</informalexample>
</para>
+ <note>
+ <para>
+ Je¶li po prostu chcesz otrzymaæ tre¶æ pliku w stringu, u¿yj
<function>file_get_contents</function>
+ dlatego, ¿e ma to du¿o lepsz± wydajno¶æ ni¿ kod powy¿ej.
+ </para>
+ </note>
<simpara>
Patrz tak¿e: <function>fwrite</function>, <function>fopen</function>,
<function>fsockopen</function>, <function>popen</function>,
@@ -84,3 +119,4 @@
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
+