(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SplFileObject::fputcsv — Écrit un tableau sous la forme d'une ligne CSV
Description
public
SplFileObject::fputcsv(
array
$fields
,
string
$separator
= ",",
string
$enclosure
= "\"",
string
$escape
= "\\"
): int|false
Liste de paramètres
-
fields
-
Un tableau de valeurs.
-
separator
-
Le paramètre optionnel delimiter
définit le
délimiteur de champs (un caractère d'un seul octet).
-
enclosure
-
Le paramètre optionnel enclosure
définit
le caractère entourant le champ (un caractère d'un seul octet).
-
escape
-
Le paramètre optionnel escape
définit le caractère d'échappement (au plus un caractère d'un seul octet).
Une chaîne de caractères vide (""
) désactive le mécanisme d'échappement propriétaire.
-
eol
-
Le paramètre optionnel eol
définit une séquence
de fin de ligne (End of Line) personnalisé.
Note:
Si un caractère enclosure
est contenu dans un champ,
il sera échappé en le doublant, à moins qu'il ne soit immédiatement précédé
d'un escape
.
Valeurs de retour
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.
Erreurs / Exceptions
Une erreur de niveau E_WARNING
est émise si
separator
ou enclosure
n'est pas un seul caractère.
Historique
Exemples
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"""
Voir aussi
- fputcsv() - Formate une ligne en CSV et l'écrit dans un fichier
- splfileobject::fgetcsv() - Récupère une ligne depuis le fichier et l'analyse comme étant des données CSV