Écrit un tableau sous la forme d'une ligne CSV

# SplFileObject::fputcsv

(PHP 5 >= 5.4.0, PHP 7)

SplFileObject::fputcsv — Écrit un tableau sous la forme d'une ligne CSV

### Description

public SplFileObject::fputcsv ( array `$fields` [, string `$delimiter` = "," [, string `$enclosure` = '"' [, string `$escape` = "\\" ]]] ) : int

Écrit un tableau `fields` sous la forme d'une ligne CSV.

### Liste de paramètres

`fields`

  Un 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 `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_char`.

### 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

An `E_WARNING` level error is issued if the `delimiter` or `enclosure` parameter is not a single character.

### Historique

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`.

### 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