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

leszek Sun Feb 8 20:58:39 2004 EDT Modified files: /phpdoc-pl/reference/filesystem/functions fgetcsv.xml Log: [adi] update to rev. 1.9 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fgetcsv.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-pl/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.2 phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.3 --- phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.2 Wed Apr 17 03:16:09 2002 +++ phpdoc-pl/reference/filesystem/functions/fgetcsv.xml Sun Feb 8 20:58:39 2004 @@ -1,71 +1,85 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 --> -<!-- last change to 'fgetcsv' 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.9 Maintainer: adi Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.fgetcsv"> <refnamediv> <refname>fgetcsv</refname> - <refpurpose> - Pobiera liniê ze wskanika pliku i przetwarza na pola CSV - </refpurpose> + <refpurpose>Pobiera liniê ze wskanika pliku i przetwarza na pola CSV</refpurpose> </refnamediv> <refsect1> <title>Opis</title> <methodsynopsis> <type>array</type><methodname>fgetcsv</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> - <methodparam choice="opt"><type>string</type><parameter> - delimiter - </parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>za³±cznik</parameter></methodparam> </methodsynopsis> <simpara> Dzia³a podobnie do <function>fgets</function> tylko, ¿e <function>fgetcsv</function> przetwarza odczytan± liniê na pola w formacie <acronym>CSV</acronym> i zwraca tablicê zawieraj±c± - odczytane pola. Delimiterem pól jest przecinek, chyba ¿e - okre¶lisz inny delimiter w opcjonalnym 3 parametrze. - </simpara> + odczytane pola. Delimiterem pól jest przecinek, chyba ¿e zostanie + podany inny w opcjonalnym trzecim parametrze <parameter>delimiter</parameter>. + Opcjonalny <parameter>za³±cznik</parameter> domy¶lnie jest ustawiony jako cudzys³ów. + Oba parametry <parameter>delimiter</parameter> i <parameter>za³±cznik</parameter> s± ograniczone + do jednego znaku. Je¶li którykolwiek z nich jest d³u¿szy, to zostanie u¿yty + pierwszy znak. + </simpara> + <note> + <simpara> + Parametr <parameter>za³±cznik</parameter> zosta³ dodany w PHP 4.3.0. + </simpara> + </note> <simpara> - <parameter>Fp</parameter> musi byæ poprawnym wska¼nikiem do pliku - poprawnie otworzonym przez <function>fopen</function> lub + <parameter>uchwyt</parameter> musi byæ poprawnym wska¼nikiem do pliku + otworzonym przez <function>fopen</function>, <function>popen</function> <function>fsockopen</function>. </simpara> <simpara> - D³ugo¶æ musi byæ wiêksza ni¿ najd³u¿sza linia znajduj±ca siê + <parameter>D³ugo¶æ</parameter> musi byæ wiêksza ni¿ najd³u¿sza linia znajduj±ca siê w pliku CSV (wliczaj±c w to znaki koñca linii). </simpara> <simpara> <function>fgetcsv</function> zwraca &false; gdy wyst±pi b³±d, w³±czaj±c w to koniec pliku. </simpara> - <simpara> - Nota bene. Pusta linia w pliku CSV zostanie zwrócona jako tablica - sk³adaj±ca siê z pojedynczego pola &null; i nie zostanie potraktowana + <note> + <simpara> + Pusta linia w pliku CSV zostanie zwrócona jako tablica + sk³adaj±ca siê z pojedynczego pola <type>null</type> i nie zostanie potraktowana jako b³±d. - </simpara> + </simpara> + </note> + <para> <example> <title> <function>fgetcsv</function> przyk³ad - Odczyt i wy¶wietlenie ca³ej zawarto¶ci pliku CSV - </title> + </title> <programlisting role="php"> <![CDATA[ +<?php $row = 1; -$fp = fopen ("test.csv","r"); -while ($data = fgetcsv ($fp, 1000, ",")) { - $num = count ($data); - print "<p> $num pola w linii $row: <br>"; +$uchwyt = fopen ("test.csv","r"); +while ($data = fgetcsv ($uchwyt, 1000, ",")) { + $num = count($data); + echo "<p> $num pól w lini $row: <br />\n"; $row++; for ($c=0; $c < $num; $c++) { - print $data[$c] . "<br>"; + echo $data[$c] . "<br />\n"; } } -fclose ($fp); +fclose ($uchwyt); +?> ]]> </programlisting> </example> + </para> + <para> + Patrz tak¿e: <function>explode</function>, <function>file</function> + i <function>pack</function> + </para> </refsect1> </refentry>