cvs: phpdoc-pl /reference/filesystem/functions fwrite.xml
| From: | Leszek Krupinski | Date: | Mon, 17 May 2004 01:03:26 +0000 |
| Subject: | cvs: phpdoc-pl /reference/filesystem/functions fwrite.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-320@lists.php.net to get a copy of this message | ||
leszek Sun May 16 21:03:26 2004 EDT
Modified files:
/phpdoc-pl/reference/filesystem/functions fwrite.xml
Log:
[adi] update to rev. 1.10
http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fwrite.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc-pl/reference/filesystem/functions/fwrite.xml
diff -u phpdoc-pl/reference/filesystem/functions/fwrite.xml:1.2
phpdoc-pl/reference/filesystem/functions/fwrite.xml:1.3
--- phpdoc-pl/reference/filesystem/functions/fwrite.xml:1.2 Wed Apr 17 03:16:09 2002
+++ phpdoc-pl/reference/filesystem/functions/fwrite.xml Sun May 16 21:03:26 2004
@@ -1,50 +1,87 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 -->
-<!-- last change to 'fwrite' 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.10 Maintainer: adi Status: ready -->
+<!-- $Revision: 1.3 $ -->
<refentry id="function.fwrite">
<refnamediv>
<refname>fwrite</refname>
- <refpurpose>Binary-safe file write</refpurpose>
+ <refpurpose>Zapis pliku binarnie bezpieczny</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<methodsynopsis>
<type>int</type><methodname>fwrite</methodname>
-
<methodparam><type>int</type><parameter>fp</parameter></methodparam>
-
<methodparam><type>string</type><parameter>string</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>
- length
- </parameter></methodparam>
+
<methodparam><type>resource</type><parameter>uchwyt</parameter></methodparam>
+
<methodparam><type>string</type><parameter>³añcuch</parameter></methodparam>
+ <methodparam
choice="opt"><type>int</type><parameter>d³ugo¶æ</parameter></methodparam>
</methodsynopsis>
<simpara>
- <function>fwrite</function> writes the contents of
- <parameter>string</parameter> to the file stream pointed to by
- <parameter>fp</parameter>. If the <parameter>length</parameter>
- argument is given, writing will stop after
- <parameter>length</parameter> bytes have been written or the end
- of <parameter>string</parameter> is reached, whichever comes
- first.
+ <function>fwrite</function> zapisuje tre¶æ
+ <parameter>³añcuch</parameter> do strumienia pliku wskazanego przez
+ <parameter>uchwyt</parameter>. Je¶li argument
<parameter>d³ugo¶æ</parameter>
+ zosta³ podany, zapis zatrzymywany jest po zapisaniu
+ <parameter>d³ugo¶æ</parameter> bajtów lub
<parameter>³añcuch</parameter>
+ skoñczy siê, cokolwiek nast±pi szybciej.
</simpara>
<simpara>
- Note that if the <parameter>length</parameter> argument is given,
- then the <link
+ <function>fwrite</function> zwraca liczbê zapisanych bajtów,
+ lub &false; w przypadku b³êdu.
+ </simpara>
+ <simpara>
+ Zauwa¿, ¿e je¶li argument <parameter>d³ugo¶æ</parameter> zosta podany,
+ to konfiguracja <link
linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
- configuration option will be ignored and no slashes will be
- stripped from <parameter>string</parameter>.
+ zostaje zignorowana i ¿adne slashe nie zostan± usuniête z
+ <parameter>³añcucha</parameter>.
</simpara>
<note>
<para>
- On systems which differentiate between binary and text files
- (i.e. Windows) the file must be opened with 'b' included in
- <function>fopen</function> mode parameter.
+ 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>.
</para>
</note>
+ <para>
+ <example>
+ <title>Prosty przyk³ad fwrite</title>
+ <programlisting role="php">
+ <![CDATA[
+ <?php
+ $nazwapliku = 'test.txt';
+ $trochetresci = "Dodaj to do pliku\n";
+
+ // Najpierw przekonaj siê czy plik istnieje i jest zapisywalny.
+ if (is_writable($nazwapliku)) {
+
+ // W naszym przyk³adzie otwieramy $nazwapliku w trybie dopisywania.
+ // Wska¼nik pliku jest ustawiony na koñcu pliku gdzie znajdzie
+ // siê zawarto¶æ $trochetresci po wykonaniu fwrite().
+ if (!$uchwyt = fopen($nazwapliku, 'a')) {
+ echo "Nie mogê otworzyæ pliku ($nazwapliku)";
+ exit;
+ }
+
+ // Zapis $trochetresci do naszego otwartego pliku.
+ if (fwrite($uchwyt, $trochetresci) === FALSE) {
+ echo "Nie mogê zapisaæ do pliku ($nazwapliku)";
+ exit;
+ }
+
+ echo "Sukces, zapisano ($trochetresci) do pliku ($nazwapliku)";
+
+ fclose($uchwyt);
+
+ } else {
+ echo "Plik $nazwapliku nie jest zapisywalny";
+ }
+ ?>
+ ]]>
+ </programlisting>
+ </example>
+ </para>
+
<simpara>
- See also <function>fread</function>, <function>fopen</function>,
- <function>fsockopen</function>, <function>popen</function>, and
- <function>fputs</function>.
+ Patrz tak¿e: <function>fread</function>, <function>fopen</function>,
+ <function>fsockopen</function> i <function>popen</function>.
</simpara>
</refsect1>
</refentry>