SplFileObject::fputcsv

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SplFileObject::fputcsv — Записати масив полів у вигляді рядка CSV

Опис

public SplFileObject::fputcsv(    array $fields,    string $separator = ",",    string $enclosure = "\"",    string $escape = "\\",    string $eol = "\n"): int|false

Записує масив fields у файл як рядок CSV.

Список параметрів

fields

Масив значень

separator

Необов'язковий параметр separator встановлює роздільник полів (лише один однобайтовий символ).

enclosure

Необов'язковий параметр enclosure (лише один однобайтовий символ). Символ обгортання використовується для розміщення значень полів. Наприклад, рядок 'рядок' обгорнутий в одиночні лапки (').

escape

Необов'язковий параметр escape встановлює символ екранування (не більше одного однобайтового символу). Порожня стрічка ("") відключає пропрієтарний механізм екранування.

eol

Необов'язковий параметр eol задає послідовність кінця рядка, що настроюється.

Зауваження :

Якщо символ enclosure міститься в полі, він буде екранований шляхом його подвоєння, якщо йому не передує escape

Значення, що повертаються

Повертає довжину записаного рядка або **false**в случае возникновения ошибки.

Повертає false і не здійснює запис у файл, якщо параметри separatorилиenclosure містять більше одного символу.

Помилки

Викликає помилку рівня E_WARNING, якщо параметри separatorилиenclosure містять більше одного символу.

список змін

Версия	Опис
8.1.0	Додано необов'язковий параметр eol
7.4.0	Тепер параметр escape може приймати порожній рядок для вимкнення пропрієтарного механізму екранування.

Приклади

Приклад #1 ПрикладSplFileObject::fputcsv()****

Loading...
▶

Приклад вище записує наступні рядки в file.csv :

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

Дивіться також

• fputcsv() - Форматує рядок у вигляді CSV і записує його у файловий покажчик
• SplFileObject::fgetcsv() - Отримати рядок із файлу та його розбір як поля CSV