(PHP 5 >= 5.3.0, PHP 7)
str_getcsv — Analisa uma string CSV e retorna os dados em um array
$input
[, string $delimiter
= ","
[, string $enclosure
= '"'
[, string $escape
= "\\"
]]] ) : arrayAnalisa 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.
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 deescape
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 deenclosure
o caractere deescape
não possui função especial; nem mesmo para escapar ao próprio.
Retorna um array com os campos lidos.
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.
|