Separar linha CSV em linhas com campos entre aspas intactos

O analisador reconhece campos entre aspas, escape com aspas duplicadas, colunas vazias e uma quebra de linha final opcional. Ele é útil quando você precisa converter uma linha copiada de uma planilha, exportação, log ou comando em uma lista para documento, formulário, script ou comparação. A mesma conversão determinística funciona no navegador e pela API, sem consulta à rede nem tentativa de adivinhar o formato.

Cole um único registro CSV completo

Informe exatamente um registro separado por vírgulas no campo de texto. Uma entrada simples como <code>vermelho,verde,azul</code> vira três linhas na mesma ordem. Colunas vazias não são descartadas: <code>vermelho,,azul,</code> gera quatro valores, incluindo o segundo e o último vazios. Isso é importante quando a posição das colunas tem significado, pois remover lacunas deslocaria todos os valores seguintes. Você pode incluir um único terminador LF, CRLF ou CR no final, o que facilita colar uma linha copiada de arquivo ou terminal. Qualquer separador de registro adicional fora de um campo entre aspas é rejeitado, porque esta capacidade foi feita para uma linha, não para um documento CSV inteiro. Ela não remove espaços nem reinterpreta números, datas, booleanos ou palavras semelhantes a nulo. Depois de decodificar a sintaxe de aspas do CSV, os caracteres de cada campo permanecem como foram enviados. Assim, o resultado é previsível para identificadores, rótulos, endereços, células e valores gerados por sistemas, nos quais uma limpeza automática poderia apagar conteúdo significativo.

Campos entre aspas são analisados como CSV

Separar uma string em toda vírgula falha assim que um endereço, uma descrição de produto ou uma frase contém pontuação. Esta capacidade usa um analisador CSV com estados. Quando um campo começa com aspas duplas, as vírgulas continuam dentro daquele valor até a aspa de fechamento correspondente. Duas aspas duplas consecutivas dentro de um campo viram uma aspa dupla literal, conforme a regra comum de escape do CSV. Quebras de linha também podem aparecer em campos entre aspas e permanecem dentro do valor. Depois da aspa de fechamento, apenas uma vírgula ou o fim do registro é válido; qualquer caractere inesperado provoca um erro de entrada claro, em vez de produzir uma lista convincente, porém incorreta. Pelo mesmo motivo, uma aspa no meio de um campo sem aspas é rejeitada. Essas verificações rigorosas revelam exportações malformadas cedo e evitam alterações silenciosas de significado. O analisador faz uma única passagem limitada, não chama serviços externos e sempre retorna o mesmo resultado para o mesmo texto.

Use o resultado vertical onde linhas ajudam

A resposta oferece um resultado unido por quebras de linha para cópia imediata, um array lines para uso estruturado e uma contagem de campos para conferência. O texto unido pode ser colado em formulário multilinha, editor, lista de permissões, configuração, chamado ou intervalo de uma coluna. O array é mais seguro no código porque preserva a fronteira de cada campo CSV, inclusive campos vazios e valores que contêm uma quebra de linha. Antes de automatizar, compare field_count com a quantidade de colunas esperada pelo sistema de destino; uma diferença costuma indicar vírgula ausente, coluna final extra ou aspas malformadas na origem. Use um analisador CSV completo quando a entrada tiver cabeçalho e vários registros, precisar de detecção de delimitador ou exigir validação por esquema. Esta capacidade focada é ideal quando você já sabe que a origem é um único registro separado por vírgulas e deseja apenas transformar campos horizontais em valores verticais. Cada solicitação pela API custa US$ 0,002; a versão do navegador executa localmente a mesma análise determinística.