cvs: phpdoc-pl /reference/filesystem/functions fgetcsv.xml
| From: | Leszek Krupinski | 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>
+ ¬e.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>