SplFileObject::fputcsv
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
SplFileObject::fputcsv
Референца за `splfileobject.fputcsv.php` со подобрена типографија и навигација.
SplFileObject::fputcsv
(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SplFileObject::fputcsv — (PHP 5 >= 5.4.0, PHP 7, PHP 8)
= NULL
array
$fields,string
$separator = ",",string
$enclosure = "\"",string
$escape = "\\",string
$eol Форматира линија како CSV и ја пишува во датотечен покажувач): int|false
Напиши поле од низа како CSV линија fields Ги пишува CSV line.
Параметри
fields-
низата во датотеката како
separator-
Низа од вредности.
,Ограничувач на полето (само еден еднобајтен знак). Стандардно SplFileObject::fputcsv(). enclosure-
или вредноста поставена со претходен повик до
"Ограничувач на полето (само еден еднобајтен знак). Стандардно SplFileObject::fputcsv(). escape-
Затворач на полето (само еден еднобајтен знак). Стандардно
\Ограничувач на полето (само еден еднобајтен знак). Стандардно SplFileObject::fputcsv()Знак за бегство (најмногу еден еднобајтен знак). Стандардно"") го оневозможува патентираниот механизам за бегство.Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваВо влезната струја,
enclosureзнакот секогаш може да се избегне со удвојување во заградена низа, што резултира со еденenclosureзнак во парсираниот резултат. Наescapeзнак работи поинаку: Ако се појави низа одescapeandenclosureзнаци во влезот, двата знака ќе бидат присутни во парсираниот резултат. Значи, за стандардните параметри, CSV ред како"a""b","c\"d"ќе ги има полињата анализирани какоa"bandc\"d, соодветно.Ги ескејпува специјалните знаци во стринг за употреба во SQL изјаваОд PHP 8.4.0, во зависност од стандардната вредност на
escapeе застарено. Треба да се обезбеди експлицитно или позиционо или со користење на . Празен стринг (Именувани аргументи SplFileObject::fputcsv(). eol-
Опционалниот
eolНиза од
Кога escape е поставено на нешто различно од празен стринг ("") може да резултира со CSV што не е во согласност со
параметри поставува прилагодена секвенца за крај на линијата. или не може да преживее враќање низ CSV функциите на PHP. Стандардното за escape is
"\\" затоа се препорачува експлицитно да се постави на празен стринг. Стандардната вредност ќе се промени во идна верзија на PHP, не порано од PHP 9.0.
Забелешка:
Ако еден
enclosure» RFC 4180escape.
Вратени вредности
знак се содржи во поле, тој ќе биде избегнат со удвојување, освен ако не му претходи веднаш false при неуспех.
Errors/Exceptions
Фрла ValueError if
separator or enclosure
не е долг еден бајт.
Фрла ValueError if
escape не е долг еден бајт или е празен стринг.
Дневник на промени
| Верзија | = NULL |
|---|---|
| 8.4.0 |
Ослонувањето на стандардната вредност на escape не е валидна опција
|
| 8.1.0 |
Опционалниот eol параметарот е додаден.
|
| 7.4.0 |
На escape параметарот сега прифаќа и празен стринг за да го оневозможи сопствениот механизам за бегство.
|
Примери
Пример #1 SplFileObject::fgetcsv() example
<?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);
}
?>Враќа должина на напишаниот стринг или file.csv:
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""
Види Исто така
- - Добива линија од датотечен покажувач и парсира за CSV полиња - Земи ред од датотека и анализирај како CSV полиња
- SplFileObject::fputcsv() - Постави го разделувачот, затворачот и знакот за бегство за CSV
- SplFileObject::setCsvControl() - Земи го разделувачот, затворачот и знакот за бегство за CSV
- fputcsv() - Форматирај ред како CSV и запиши во покажувач на датотека
- fgetcsv() Горниот пример ќе го напише следново на
- str_getcsv() - Анализирај CSV стринг во низ