SplFileObject::fgetcsv - Получение строки файла и ее разбор в соответствии с CSV разметкой
Вернуться к: SplFileObject
SplFileObject::fgetcsv
(PHP 5 >= 5.1.0, PHP 7)
SplFileObject::fgetcsv — Получение строки файла и ее разбор в соответствии с CSV разметкой
Описание
$delimiter
= ","
[, string $enclosure
= "\""
[, string $escape
= "\\"
]]] )Извлекает строку из файла и разбирает ее в соответствии с форматом CSV. Результаты разбора возвращает в виде массива.
Список параметров
-
delimiter
-
Разделитель полей (один символ). По умолчанию это запятая или символ, который был задан методом SplFileObject::setCsvControl().
-
enclosure
-
Символ обрамления полей (один символ). По умолчанию это двойная кавычка или символ, который был задан методом SplFileObject::setCsvControl().
-
escape
-
Экранирующий символ (один символ). По умолчанию это обратный слеш (\) или символ, который был задан методом SplFileObject::setCsvControl().
Возвращаемые значения
Возвращает массив содержащий данные прочитанной строки или FALSE
в случае
ошибки.
Замечание:
Пустая строка CSV файла будет возвращаться в виде массива, содержащего единственный элемент
NULL
, если не включена опцияSplFileObject::SKIP_EMPTY | SplFileObject::DROP_NEW_LINE
, которая позволяет пропускать пустые строки.
Примеры
Пример #1 Пример использования SplFileObject::fgetcsv()
<?php
$file = new SplFileObject("data.csv");
while (!$file->eof()) {
var_dump($file->fgetcsv());
}
?>
Пример #2 Пример использования SplFileObject::READ_CSV
<?php
$file = new SplFileObject("animals.csv");
$file->setFlags(SplFileObject::READ_CSV);
foreach ($file as $row) {
list($animal, $class, $legs) = $row;
printf("A %s is a %s with %d legs\n", $animal, $class, $legs);
}
?>
Contents of animals.csv
crocodile,reptile,4 dolphin,mammal,0 duck,bird,2 koala,mammal,4 salmon,fish,0
Результатом выполнения данного примера будет что-то подобное:
A crocodile is a reptile with 4 legs A dolphin is a mammal with 0 legs A duck is a bird with 2 legs A koala is a mammal with 4 legs A salmon is a fish with 0 legs
Смотрите также
- SplFileObject::setCsvControl() - Устанавливает символы разделителя и ограничителя для CSV
- SplFileObject::setFlags() - Устанавливает флаги для SplFileObject
- SplFileObject::READ_CSV
- SplFileObject::current() - Получение текущей строки файла
Вернуться к: SplFileObject