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

From: Date: Sun, 27 Feb 2005 01:09:15 +0000
Subject: cvs: phpdoc-pl /reference/filesystem/functions fgetcsv.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-478@lists.php.net to get a copy of this message
leszek Sat Feb 26 20:09:15 2005 EDT Modified files: /phpdoc-pl/reference/filesystem/functions fgetcsv.xml Log: [adi] update to rev 1.17 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/fgetcsv.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-pl/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.4 phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.5 --- phpdoc-pl/reference/filesystem/functions/fgetcsv.xml:1.4 Tue Apr 6 21:03:33 2004 +++ phpdoc-pl/reference/filesystem/functions/fgetcsv.xml Sat Feb 26 20:09:15 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.10 Maintainer: adi Status: ready --> -<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.17 Maintainer: adi Status: ready --> +<!-- $Revision: 1.5 $ --> <refentry id="function.fgetcsv"> <refnamediv> <refname>fgetcsv</refname> @@ -11,35 +11,54 @@ <methodsynopsis> <type>array</type><methodname>fgetcsv</methodname> <methodparam><type>resource</type><parameter>uchwyt</parameter></methodparam> - <methodparam><type>int</type><parameter>d³ugo¶æ</parameter></methodparam> + <methodparam choice="opt"><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>za³±cznik</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>ogranicznik</parameter></methodparam> </methodsynopsis> + <para> + <variablelist> + <varlistentry> + <term><parameter>uchwyt</parameter></term> + <listitem> + <simpara> + Wa¿ny uchwyt pliku, poprawnie otwartego za pomoc± <function>fopen</function>, + <function>popen</function> lub <function>fsockopen</function>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>d³ugo¶æ</parameter> (opcjonalny)</term> + <listitem> + <simpara> + Musi byæ wiêkszy ni¿ najd³u¿sza linia (w znakach), która znajduje siê w pliku CSV + (wliczaj±c znaki koñca lini). Sta³ siê opcjonalny w PHP 5. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>delimiter</parameter> (opcjonalny)</term> + <listitem> + <simpara> + Ustawia delimeter (tylko jeden znak) pól. Domy¶lnie przecinek. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>ogranicznik</parameter> (opcjonalny)</term> + <listitem> + <simpara> + Ustawia znak ograniczaj±cy pole. Domy¶lnie jest to cudzys³ów. Dodano w PHP 4.3.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> <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 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. + odczytane pola. </simpara> - <note> - <simpara> - Parametr <parameter>za³±cznik</parameter> zosta³ dodany w PHP 4.3.0. - </simpara> - </note> - <simpara> - <parameter>uchwyt</parameter> musi byæ poprawnym wska¼nikiem do pliku - otworzonym przez <function>fopen</function>, <function>popen</function> - <function>fsockopen</function>. - </simpara> - <simpara> - <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. @@ -62,9 +81,9 @@ <?php $row = 1; $uchwyt = fopen ("test.csv","r"); -while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) { +while (($data = fgetcsv($uchwyt, 1000, ",")) !== FALSE) { $num = count($data); - echo "<p> $num pól w lini $row: <br />\n"; + echo "<p> $num pól w lini $row: <br /></p>\n"; $row++; for ($c=0; $c < $num; $c++) { echo $data[$c] . "<br />\n"; @@ -75,10 +94,22 @@ ]]> </programlisting> </example> - </para> + </para> + <para> + <function>fgetcsv</function> jest bezpieczna binarnie od PHP 4.3.5 + </para> + <note> + <simpara> + Ustawienia lokale s± brane pod uwagê przez tê funkcjê. Je¶li + <varname>LANG</varname> jest ustawione na np. <literal>en_US.UTF-8</literal>, + pliki z jedno bajtowym kodowaniem zostan± nieprawid³owo odczytane + przez funkcjê. + </simpara> + </note> + &note.line-endings; <para> - Patrz tak¿e: <function>explode</function>, <function>file</function> - i <function>pack</function> + Patrz tak¿e: <function>explode</function>, <function>file</function>, + <function>pack</function> i <function>fputcsv</function>. </para> </refsect1> </refentry>

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