fgetcsv
Gets line from file pointer and parse for CSV fields
&reftitle.description;
arrayfgetcsv
resourcehandle
intlength0
stringdelimiter","
stringenclosure'"'
stringescape"\"
Similar to fgets except that
fgetcsv parses the line it reads for fields in
CSV format and returns an array containing the fields
read.
&reftitle.parameters;
handle
A valid file pointer to a file successfully opened by
fopen, popen, or
fsockopen.
length
Must be greater than the longest line (in characters) to be found in
the CSV file (allowing for trailing line-end characters). Otherwise the
line is split in chunks of length characters,
unless the split would occur inside an enclosure.
Omitting this parameter (or setting it to 0 in PHP
5.1.0 and later) the maximum line length is not limited, which is
slightly slower.
delimiter
The optional delimiter parameter sets the field delimiter (one character only).
enclosure
The optional enclosure parameter sets the field enclosure character (one character only).
escape
The optional escape parameter sets the escape character (one character only).
&reftitle.returnvalues;
Returns an indexed array containing the fields read.
A blank line in a CSV file will be returned as an array
comprising a single null field, and will not be treated
as an error.
¬e.line-endings;
fgetcsv returns &null; if an invalid
handle is supplied or &false; on other errors,
including end of file.
&reftitle.changelog;
&Version;
&Description;
5.3.0
The escape parameter was added
5.1.0
The length is now optional.
Default is 0, meaning no length limit.
4.3.5
fgetcsv is now binary safe
&reftitle.examples;
Read and print the entire contents of a CSV file
$num fields in line $row:
\n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . "
\n";
}
}
fclose($handle);
}
?>
]]>
&reftitle.notes;
Locale setting is taken into account by this function. If
LANG is e.g. en_US.UTF-8, files in
one-byte encoding are read wrong by this function.
&reftitle.seealso;
str_getcsv
explode
file
pack
fputcsv