str_getcsv

(PHP 5 >= 5.3.0, PHP 7)

str_getcsv Analisa uma string CSV e retorna os dados em um array

Descrição

str_getcsv ( string $input [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\\" ]]] ) : array

Analisa a string passada por campos no formato CSV e retorna um array contendo os campos encontrados.

Nota:

As configurações de localização são levadas em conta nessa função. Se LC_CTYPE for, por exemplo, en_US.UTF-8, strings com codificação de um byte podem ser lidas de forma errada na função.

Parâmetros

input

Srting a ser analisada.

delimiter

Define o delimitador (somente um caractere).

enclosure

Define o enclosure (somente um caractere).

escape

Define o caractere de escape (no máximo um caractere). O valor padrão é a barra invertida (\) Uma string vazia ("") desabilita o mecanismo de escape.

Nota: Normalmente um caractere de enclosure é escapado dentro do campo duplicando ele; entretanto, o caratere de escape pode ser utilizado como alternativa. Então, para os valores padrões dos parâmetros "" e \" tem o mesmo significado. Além de escapar o caractere de enclosure o caractere de escape não possui função especial; nem mesmo para escapar ao próprio.

Valor Retornado

Retorna um array com os campos lidos.

Changelog

Versão Descrição
7.4.0 O parâmetro escape agora interpreta uma string vazia como um sinal para desabilitar o mecanismo de escape. Antes, uma string vazia utilizava o valor padrão do parâmetro.

Veja Também

  • fgetcsv() - Lê uma linha do ponteiro de arquivos e a interpreta como campos CSV