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