str_getcsv
(PHP 5 >= 5.3.0, PHP 7)
str_getcsv — CSV 文字列をパースして配列に格納する
説明
str_getcsv
( string $string
[, string $separator = ","
[, string $enclosure = "\""
[, string $escape = '\\'
]]] ) : array
CSV 形式の文字列入力のフィールドをパースして、 読み込んだフィールドの内容を配列で返します。
注意:
この関数はロケール設定を考慮します。もし
LC_CTYPEが例えばen_US.UTF-8の場合、 1 バイトエンコーディングの文字列は間違って読み込まれるかもしれません。
パラメータ
stringパースする文字列。
separatorフィールド区切り文字 (1 文字のみ)。
enclosureフィールド囲み文字 (1 文字のみ)。
escapeエスケープ文字 (最大1文字)。デフォルトはバックスラッシュ (
\)。 空文字列 ("") を指定すると、 プロプライエタリなエスケープ機構を無効にします。注意:
通常、
enclosureの文字は、 フィールドの中では二回出力されることでエスケープされます。 しかし、escapeの文字を代わりに使うこともできます。 よって、デフォルト値""および\"は同じ意味になります。enclosure文字をエスケープすることを許可する以外に、escape文字は特別な意味を何ら持ちません; つまり、自分自身をエスケープすることすら意味しません。
返り値
読み込んだフィールドの内容を配列で返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 7.4.0 | escape 引数は、
空文字列を、プロプライエタリなエスケープ機構を無効にするシグナルとして解釈するようになりました。 これより前のバージョンでは、空文字列はデフォルト値のように扱われていました。 |
