SplFileObject::fputcsv

(PHP 5 >= 5.4.0)

SplFileObject::fputcsv — Escribir un array de campos como una línea CSV

Descripción

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

Escribe el array fields en el fichero como una línea CVS.

Parámetros

fields: Un array de valores.
delimiter: El parámetro opcional delimiter establece el delimitador de campos (sólo un carácter).
enclosure: El parámetro opcional enclosure establece el carácter circundante de cada campo (sólo un carácter).

Valores devueltos

Devuelve la longitud del string escrito o FALSE en caso de error.

Devuelve FALSE, y no escribe la línea CVS en el fichero, si el parámetro delimiter o enclosure no es un único carácter.

Errores/Excepciones

Emite un error de nivel E_WARNING si el parámetro delimiter o enclosure no es un único carácter.

Ejemplos

Ejemplo #1 Ejemplo de SplFileObject::fputcsv()


<?php

$lista = array (
    array('aaa', 'bbb', 'ccc', 'dddd'),
    array('123', '456', '789'),
    array('"aaa"', '"bbb"')
);

$fichero = new SplFileObject('fichero.csv', 'w');

foreach ($lista as $campos) {
    $fichero->fputcsv($campos);
}

?>

El ejemplo anterior escribirá lo siguiente en fichero.csv:

aaa,bbb,ccc,dddd
123,456,789
"""aaa""","""bbb"""

Ver también

fputcsv() - Dar formato CSV a una línea y escribirla en un puntero a un fichero
SplFileObject::fgetcsv() - Obtiene una línea de un fichero y la analiza como campos CSV