Aspas em campo CSV

O CSV parece simples até que um nome de produto contenha vírgula, uma nota traga aspas duplas ou uma célula ocupe duas linhas. Um campo mal aspeado quebra parsers, planilhas e pipelines de dados de formas difíceis de notar depois. Use quando precisar de um oráculo confiável para uma célula — não de um parser CSV completo — antes de montar ou dividir linhas em outro lugar.

Como a RFC 4180 coloca aspas em um único campo CSV

A RFC 4180 define CSV como registros de campos separados por vírgulas, com fechamento opcional em aspas duplas para campos que de outro modo seriam ambíguos. Um campo que contém vírgula, aspas duplas, retorno de carro ou quebra de linha deve ser envolvido em aspas duplas. Dentro de um campo aspeado, uma aspa dupla literal escreve-se como duas aspas duplas seguidas — nunca como escape com barra invertida.

Campos sem esses caracteres especiais podem ficar nus, embora produtores possam aspear todos por uniformidade. Esta capacidade implementa esse contrato para exatamente um token de campo. No modo quote, varre o valor bruto em busca de vírgula, aspa, CR e LF; se algum aparecer, ou se force for true, monta um token aspeado envolvendo o texto e substituindo cada aspa embutida por um par duplicado.

Se nenhum aparecer e force for false, o valor bruto volta inalterado para identificadores simples permanecerem compactos. No modo unquote, uma aspa dupla inicial significa que o token inteiro está aspeado: o caractere final também deve ser aspa dupla, cada aspa interior deve aparecer em par, e o corpo recuperado volta sem o fechamento externo. Um token nu sem aspa inicial volta como está, mas um token nu que ainda contenha aspas é rejeitado porque essa forma não é um campo sem aspas válido sob a RFC 4180.

O que você envia e o que recebe de volta

Envie um campo string obrigatório chamado text e campos opcionais mode e force. O modo quote converte texto bruto da célula em um token de campo RFC 4180 em result. O modo unquote inverte as aspas em text e devolve o valor plano recuperado em result.

Force tem padrão false, então o modo quote só envolve quando o campo contém vírgula, aspa, CR ou LF; defina force true quando seu produtor sempre aspear cada célula por layout uniforme. Falhas de validação não consomem saldo pré-pago. Verificações clássicas incluem aspear uma saudação com aspas e vírgula embutidas, desfazer o token resultante até os caracteres originais, forçar aspas em uma palavra simples que de outro modo ficaria nua, e rejeitar uma string aspeada que nunca fecha.

Onde um aspeador de um único campo CSV vale a pena

Geradores de código e jobs ETL que montam linhas CSV célula a célula devem aspear cada campo de texto livre antes de juntar com vírgulas, ou um único título de produto com vírgula deslocará todas as colunas seguintes. Ajudantes de importação de planilha e ferramentas de suporte colam uma célula bagunçada por vez e precisam de um caminho reversível que falhe alto em tickets pela metade aspeados em vez de truncar em silêncio.

Autores de currículo que ensinam higiene de dados querem uma página dedicada a aspas em nível de campo em vez de enterrar a regra sob um limpador CSV multilinha, porque a intenção de busca difere: quem procura aspear ou remover aspas de um campo CSV quer as regras de escape, não renomear colunas nem deduplicar. Validação falha não consome saldo.

Mantenha cada requisição em um campo, fixe as strings de resultado nos testes e você obtém aspas reproduzíveis para geradores, plugins LMS e workers de borda sem carregar um framework CSV completo por uma única célula.