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, то строки в однобайтовой кодировке будут неправильно прочитаны этой функцией.

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

string: Обрабатываемая строка.
separator: Устанавливает разделитель поля (только один символ).
enclosure: Устанавливает символ ограничителя поля (только один символ).
escape: Устанавливает экранирующий символ (только один символ). По умолчанию равен обратному слешу (\). Пустая строка ("") отключает проприетарный механизм экранирования.

Замечание: Обычно символ enclosure экранируется внутри поля путем его удваивания; однако, символ escape в качестве альтернативы. Поэтому значения по умолчанию этих параметров "" и \" имеют одинаковое значение. Помимо разрешения экранировать символ enclosure символ escape не имеет особого смысла; он даже не предназначен для самого экранирования.

Возвращаемые значения

Возвращает индексированный массив, содержащий полученные из строки поля.

Список изменений

Версия	Описание
7.4.0	Теперь пустой параметр `escape` будет интерпретироваться как требование отключения проприетарного механизма экранирования. Ранее пустая строка обозначала использование символа экранирования по умолчанию.

Смотрите также

fgetcsv() - Читает строку из файла и производит разбор данных CSV