(PHP 5 >= 5.4.0, PHP 7)
SplFileObject::fputcsv — Écrit un tableau sous la forme d'une ligne CSV
$fields
[, string $delimiter = ","
[, string $enclosure = '"'
[, string $escape = "\\"
]]] ) : int
Écrit un tableau fields sous la forme d'une ligne CSV.
fieldsUn tableau de valeurs.
delimiter
Le paramètre optionnel delimiter définit le
délimiteur de champs (un seul caractère).
enclosure
Le paramètre optionnel enclosure définit
le caractère entourant le champ (un seul caractère).
escape
Le paramètre optionnel escape
définit le caractère d'échappement (au plus un caractère).
Une chaîne de caractères vide ("") désactive le mécanisme d'échappement propriétaire.
Note:
Si un caractère
enclosureest contenu dans un champ, il sera échappé en le doublant, à moins qu'il ne soit immédiatement précédé d'unescape_char.
Retourne la longueur de la chaîne écrite ou FALSE si une erreur survient.
Retourne FALSE, et n'écrit pas la ligne CSV dans le fichier si
le paramètre delimiter ou le paramètre
enclosure n'est pas un caractère unique.
An E_WARNING level error is issued if the
delimiter or enclosure
parameter is not a single character.
| Version | Description |
|---|---|
| 7.4.0 |
Le paramètre escape accepte désormais une chaîne de
charactère vide afin de désactivé le mécanisme d'échapement propriétaire.
|
| 5.5.21, 5.6.5 |
Ajout du paramètre escape.
|
Exemple #1 Exemple avec SplFileObject::fputcsv()
<?php
$list = array (
array('aaa', 'bbb', 'ccc', 'dddd'),
array('123', '456', '789'),
array('"aaa"', '"bbb"')
);
$file = new SplFileObject('file.csv', 'w');
foreach ($list as $fields) {
$file->fputcsv($fields);
}
?>
L'exemple suivant va écrire la ligne suivante dans le fichier file.csv :
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""