SplFileObject::fputcsv
Write a field array as a CSV line
&reftitle.description;
public intfalseSplFileObject::fputcsv
arrayfields
stringseparator","
stringenclosure"\""
stringescape"\\"
stringeol"\n"
Writes the fields array to the file as a CSV line.
&reftitle.parameters;
fields
An array of values.
separator
The optional separator parameter sets the field
delimiter (one single-byte character only).
enclosure
The optional enclosure parameter sets the field
enclosure (one single-byte character only).
escape
The optional escape parameter sets the
escape character (at most one single-byte character).
An empty string ("") disables the proprietary escape mechanism.
eol
The optional eol parameter sets
a custom End of Line sequence.
If an enclosure character is contained in a field,
it will be escaped by doubling it, unless it is immediately preceded by an
escape.
&reftitle.returnvalues;
Returns the length of the written string&return.falseforfailure;.
Returns &false;, and does not write the CSV line to the file, if the
separator or enclosure
parameter is not a single character.
&reftitle.errors;
An E_WARNING level error is issued if the
separator or enclosure
parameter is not a single character.
&reftitle.changelog;
&Version;
&Description;
8.1.0
The optional eol parameter has been added.
7.4.0
The escape parameter now also accepts an empty
string to disable the proprietary escape mechanism.
&reftitle.examples;
SplFileObject::fputcsv example
fputcsv($fields);
}
?>
]]>
The above example will write the following to file.csv:
&reftitle.seealso;
fputcsv
SplFileObject::fgetcsv