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

From: 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 --> +

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