Campos separados e registros em texto
O CSV (comma-separated values) é um formato de arquivo de texto para representar tabelas. Cada registro reúne campos separados por vírgulas na forma descrita pela RFC 4180. Um cabeçalho opcional identifica as colunas para a aplicação que vai ler o arquivo.
As aspas duplas delimitam campos que contêm uma vírgula ou uma quebra de linha. Por isso, uma quebra de linha dentro de um campo entre aspas não encerra o registro. A leitura precisa reconhecer esses delimitadores para reconstruir a tabela.
Uma vírgula que faz parte do nome
Este arquivo didático tem duas colunas e um registro de contato:
nome,email"Oliveira, Ana",ana@example.comO campo nome contém o texto Oliveira, Ana inteiro porque as aspas delimitam o nome e preservam a vírgula interna. A vírgula depois das aspas separa o email do nome. Uma divisão feita apenas com split(",") criaria três campos na segunda linha e interpretaria esse registro incorretamente.
Existem arquivos chamados CSV que usam outros separadores. Você precisa configurar o importador conforme o arquivo recebido e conferir a codificação para preservar os acentos. Depois da leitura, compare os registros importados com o original, sobretudo quando a aplicação converter textos em números ou datas.
Dúvidas frequentes
Perguntas frequentes sobre CSV
- O cabeçalho é obrigatório num CSV?
- A RFC 4180 permite um cabeçalho opcional. Você precisa conferir se a primeira linha traz nomes de colunas ou já contém um registro.
- Como representar aspas dentro de um campo?
- Na forma descrita pela RFC 4180, o campo fica entre aspas duplas e cada aspa interna aparece duplicada. O texto Loja "Centro" é escrito como "Loja ""Centro""".
- O CSV conserva os tipos de uma planilha?
- O arquivo guarda a representação textual dos campos. A aplicação de destino determina a conversão, por isso um identificador como 00123 precisa ser importado como texto para preservar os zeros iniciais.
Para continuar
Recursos relacionados
Documentação
RFC 4180: campos e registros no formato CSV
Descreve o cabeçalho opcional, os campos entre aspas e a duplicação de aspas internas no formato CSV.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar a leitura de arquivos e investigar conversões incorretas durante uma importação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A importação de tabelas exige interpretar os campos do arquivo e conferir como a aplicação converte os valores recebidos.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.