PHP.mk документација

SplFileObject::fputcsv

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

splfileobject.fputcsv.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека splfileobject.fputcsv.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
SplFileObject::fputcsv

Референца за `splfileobject.fputcsv.php` со подобрена типографија и навигација.

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

public SplFileObject::fputcsv(
         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 знак работи поинаку: Ако се појави низа од escape and enclosure знаци во влезот, двата знака ќе бидат присутни во парсираниот резултат. Значи, за стандардните параметри, CSV ред како "a""b","c\"d" ќе ги има полињата анализирани како a"b and c\"d, соодветно.

Ги ескејпува специјалните знаци во стринг за употреба во SQL изјава

Од PHP 8.4.0, во зависност од стандардната вредност на escape е застарено. Треба да се обезбеди експлицитно или позиционо или со користење на . Празен стринг (Именувани аргументи SplFileObject::fputcsv().

eol

Опционалниот eol Низа од

Ги ескејпува специјалните знаци во стринг за употреба во SQL изјава

Кога escape е поставено на нешто различно од празен стринг ("") може да резултира со CSV што не е во согласност со параметри поставува прилагодена секвенца за крај на линијата. или не може да преживее враќање низ CSV функциите на PHP. Стандардното за escape is "\\" затоа се препорачува експлицитно да се постави на празен стринг. Стандардната вредност ќе се промени во идна верзија на PHP, не порано од PHP 9.0.

Забелешка:

Ако еден enclosure » RFC 4180 escape.

Вратени вредности

знак се содржи во поле, тој ќе биде избегнат со удвојување, освен ако не му претходи веднаш 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"""

Види Исто така

Белешки од корисници

Нема белешки од корисници за оваа страница.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.