cvs: phpdoc-pl /reference/filesystem/functions fscanf.xml
| From: | Leszek Krupinski | Date: | Mon, 28 Feb 2005 01:12:37 +0000 |
| Subject: | cvs: phpdoc-pl /reference/filesystem/functions fscanf.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-496@lists.php.net to get a copy of this message | ||
leszek Sun Feb 27 20:12:37 2005 EDT
Modified files:
/phpdoc-pl/reference/filesystem/functions fscanf.xml
Log:
[adi] update to rev 1.16
http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fscanf.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-pl/reference/filesystem/functions/fscanf.xml
diff -u phpdoc-pl/reference/filesystem/functions/fscanf.xml:1.3
phpdoc-pl/reference/filesystem/functions/fscanf.xml:1.4
--- phpdoc-pl/reference/filesystem/functions/fscanf.xml:1.3 Fri May 17 09:50:49 2002
+++ phpdoc-pl/reference/filesystem/functions/fscanf.xml Sun Feb 27 20:12:37 2005
@@ -1,8 +1,6 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 -->
-<!-- last change to 'fscanf' 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.16 Maintainer: adi Status: ready -->
+<!-- $Revision: 1.4 $ -->
<refentry id="function.fscanf">
<refnamediv>
<refname>fscanf</refname>
@@ -12,36 +10,47 @@
<title>Opis</title>
<methodsynopsis>
<type>mixed</type><methodname>fscanf</methodname>
-
<methodparam><type>int</type><parameter>uchwyt</parameter></methodparam>
+
<methodparam><type>resource</type><parameter>uchwyt</parameter></methodparam>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>war1</parameter></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter
role="reference">...</parameter></methodparam>
</methodsynopsis>
<para>
Funkcja <function>fscanf</function> jest podobna do
<function>sscanf</function>, ale pobiera dane wej¶ciowe z pliku
skojarzonego z <parameter>uchwyt</parameter>em i interpretuje je
- zgodnie z podanych <parameter>format</parameter>em.
+ zgodnie z podanym <parameter>format</parameter>em, który opisany jest
+ w dokumentacji do <function>sprintf</function>.
Je¶li tylko dwa parametry zostan± podane do funkcji, przetworzone
warto¶ci zostan± zwrócone w tablicy.
W przeciwnym razie, je¶li opcjonalne parametry zostan± podane,
funkcja zwróci numer przypisany do warto¶ci. Opcjonalny parametr
musi byæ podawany przez referencje.
+ </para>
+ <para>
+ Dowolny bia³y znak w ³añcuchu formatuj±cym pasuje do dowolnego bia³ego znaku
+ w strumieniu wej¶ciowym. To znaczy, ¿e nawet tabulacja <literal>\t</literal>
+ w ³añcuchu formatuj±cym mo¿e byæ dopasowana do pojedynczego znaku spacji
+ w strumieniu wej¶ciowym.
+ </para>
+ <para>
<example>
<title><function>fscanf</function> Przyk³ad</title>
<programlisting role="php">
<![CDATA[
-$fp = fopen ("users.txt","r");
-while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
+<?php
+$uchwyt = fopen("users.txt", "r");
+while ($userinfo = fscanf($uchwyt, "%s\t%s\t%s\n")) {
list ($name, $profession, $countrycode) = $userinfo;
- //... zrób co¶ z warto¶ciami
+ //... zrób co¶ z warto¶ciami
}
-fclose($fp);
+fclose($uchwyt);
+?>
]]>
</programlisting>
</example>
<example>
- <title>users.txt</title>
- <programlisting>
+ <title>Zawarto¶æ pliku users.txt</title>
+ <programlisting role="txt">
<![CDATA[
javier argonaut pe
hiroshi sculptor jp
@@ -51,6 +60,13 @@
</programlisting>
</example>
</para>
+ <note>
+ <simpara>
+ Przed PHP 4.3.0, maksymaln± liczb± znaków czytanych z pliku by³o
+ 512 (lub do pierwszego wyst±pienia \n, cokolwiek nast±pi³o pierwsze).
+ Od PHP 4.3.0 dowolnie d³ugie linie s± czytane i skanowane.
+ </simpara>
+ </note>
<para>
Patrz tak¿e: <function>fread</function>, <function>fgets</function>,
<function>fgetss</function>, <function>sscanf</function>,