fgetcsv
Obtient une ligne depuis un pointeur de fichier et l'analyse pour des champs CSV
&reftitle.description;
arrayfalsefgetcsv
resourcestream
intnulllength&null;
stringseparator","
stringenclosure"\""
stringescape"\\"
Similaire à fgets mais fgetcsv
analyse la ligne qu'il lit et recherche les champs CSV,
qu'il va retourner dans un tableau les contenant.
La définition des locales entre en jeu avec cette fonction. Si
LC_CTYPE vaut, par exemple en_US.UTF-8,
les fichiers encodés avec un encodage d'un octet peuvent être mal lus par cette fonction.
&reftitle.parameters;
stream
Un pointeur valide sur un fichier ouvert avec fopen,
popen ou fsockopen.
length
Doit être plus grand que la plus grande ligne (en terme de caractères)
à lire dans le fichier (y compris le caractère de fin de ligne).
Dans le cas contraire la ligne sera scindée en tranches de length caractères,
sauf si la scission se produit à l'intérieur d'un encadrement.
Omettre ce paramètre (ou le définir à 0, ou &null; en PHP 8.0.0 ou
ultérieur) fait que la longueur maximale de la ligne n'est pas limitée,
ce qui est légèrement plus lent.
separator
Le paramètre optionnel separator définit le séparateur de champ (un caractère d'un seul octet).
enclosure
Le paramètre optionnel enclosure définit le caractère d'encadrement de texte (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 &string; vide ("") désactive le mécanisme d'échappement propriétaire.
En général un caractère d'encadrement enclosure est
échappé à l'intérieur d'un champ en le dédoublant ;
Cependant, le caractère d'échappement escape peut être utilisé comme une alternative.
Donc pour la valeur par défaut "" et \"
ont la même signification. Outre échapper le caractère d'encadrement enclosure
le caractère d'échappement escape n'a pas de
signification spéciale ; même pas de s'échapper lui-même.
&reftitle.returnvalues;
Retourne un tableau indexé contenant les champs lus en cas de succès, &return.falseforfailure;.
Une ligne vide dans un fichier CSV sera retournée sous la
forme d'un tableau contenant la valeur &null; et ne sera pas traitée
comme une erreur.
¬e.line-endings;
&reftitle.changelog;
&Version;
&Description;
8.0.0
length est désormais nullable.
7.4.0
Le paramètre escape accepte désormais une chaîne de
caractère vide afin de désactiver le mécanisme d'échappement propriétaire.
&reftitle.examples;
Lit et affiche le contenu d'un fichier CSV
$num champs à la ligne $row:
\n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . "
\n";
}
}
fclose($handle);
}
?>
]]>
&reftitle.seealso;
str_getcsv
explode
file
pack
fputcsv