Como formatar texto CSV com delimitadores e aspas

Para que serve o formatador de CSV

O formatador de CSV transforma texto separado por delimitadores numa versão reescrita com uma apresentação de CSV consistente. É útil quando precisa de rever rapidamente a estrutura de um conteúdo, escolher o separador usado ou controlar a forma como os campos são colocados entre aspas. Pode trabalhar com o separador predefinido, a vírgula, ou adaptar a configuração ao formato do seu texto.

Como formatar o texto CSV

1. Cole o texto CSV na área de entrada. Para uma entrada vazia ou composta apenas por espaços, o resultado será um conteúdo formatado vazio, com zero linhas e zero colunas.

2. Se necessário, selecione o delimitador que separa os campos no seu texto, como a vírgula. Escolha também o carácter de aspas utilizado pelos valores. As predefinições são vírgula como delimitador, aspas duplas como carácter de aspas e o modo de formatação pretty.

3. Escolha o modo de formatação. O valor minimal aplica a colocação mínima de aspas própria de CSV. Qualquer outro valor de formatação segue o modo que coloca aspas em todos os campos.

4. Inicie o processamento e consulte o texto reescrito. Para uma entrada não vazia, o conteúdo é interpretado em linhas segundo o delimitador e o carácter de aspas selecionados e depois reescrito com essas definições. Se o seu texto usa ponto e vírgula, por exemplo, selecione esse carácter em vez de manter a vírgula.

5. Reveja a indicação de erro, caso seja apresentada. Quando ocorre uma exceção durante o processamento, o resultado continua a ser devolvido, mas o conteúdo formatado fica vazio e as contagens de linhas e colunas ficam a zero.

Como interpretar o resultado

As contagens ajudam a confirmar se o texto foi lido com a configuração esperada. O número de linhas corresponde às linhas interpretadas, enquanto o número de colunas corresponde à maior quantidade de campos encontrada numa linha. Assim, duas linhas com três campos cada devem produzir duas linhas e três colunas.

O texto apresentado não é uma simples cópia do conteúdo original: para entradas não vazias, as linhas interpretadas são reescritas segundo o delimitador, o carácter de aspas e o modo escolhidos. Alterar o delimitador pode, por isso, alterar a forma como os campos são reconhecidos. Do mesmo modo, minimal e os restantes valores não devem ser tratados como modos equivalentes de colocação de aspas.

Se o resultado tiver zero linhas e zero colunas, verifique primeiro se a entrada estava vazia ou apenas continha espaços. Se existir uma descrição de erro, considere-a juntamente com o conteúdo vazio, porque esse padrão também pode indicar que ocorreu uma exceção durante o processamento.

Exemplo prático

Uma pessoa precisa de confirmar se duas linhas de dados com três campos separados por vírgulas foram interpretadas como uma tabela de duas linhas.

Cole duas linhas de texto CSV, cada uma com três campos separados por vírgulas, mantenha a vírgula e as aspas duplas selecionadas e inicie o processamento.

O resultado indica 2 linhas e 3 colunas e apresenta o texto CSV reescrito de acordo com as definições selecionadas.

Limitações

• A ferramenta reescreve as linhas interpretadas, mas o resultado não deve ser tratado como uma validação independente do CSV; entradas que provoquem uma exceção devolvem conteúdo formatado vazio e contagens a zero.

Erros comuns

• Escolher o delimitador errado: os campos podem ser interpretados de forma diferente da esperada. Corrija o delimitador para corresponder ao carácter que separa os valores no texto de entrada e volte a processar.

Perguntas frequentes

Qual é o delimitador predefinido?

O delimitador predefinido é a vírgula. Se o texto usar outro carácter, selecione-o antes de iniciar o processamento para que os campos sejam interpretados de acordo com essa separação.

Qual é a diferença entre minimal e os outros modos?

minimal aplica a colocação mínima de aspas. Qualquer outro valor de formatação segue o modo de colocação de aspas em todos os campos.

O que significa obter zero linhas e zero colunas?

Se a entrada estiver vazia ou contiver apenas espaços, o resultado é devolvido com conteúdo vazio e zero linhas e colunas. Se for apresentada uma descrição de erro, pode ter ocorrido uma exceção e o resultado seguirá igualmente com conteúdo vazio e essas contagens a zero.