Porque é que a minha referência 007 não passou a número?

Porque não é um número, mas uma cadeia com um zero significativo. Se saísse sem aspas, o PHP leria 007 como número octal, o JavaScript em modo estrito recusaria executar o ficheiro e o Python 3 daria um erro de sintaxe. Só saem sem aspas as cadeias que depois de Number() se escrevem exatamente da mesma maneira.

Posso colar uma coluna diretamente do Excel ou do Google Sheets?

Sim. Copiar uma coluna dá um valor por linha — exatamente o formato que o campo de entrada espera. Se as células tinham espaços inquebráveis, a ferramenta avisa: visualmente não se distinguem dos normais, mas nas comparações esses valores nunca coincidem.

O que fazer com valores que têm apóstrofo ou barra invertida?

Nada — são escapados automaticamente, e exatamente como a linguagem escolhida exige. É a principal razão pela qual a mesma lista não pode passar por um modelo universal: em PHP com aspas simples escapam-se dois carateres, em Perl com aspas duplas, quatro.

Porque é que o separador SQL não escapa a barra invertida?

Porque a norma SQL conhece apenas uma forma de escape — duplicar o apóstrofo. No PostgreSQL e no MySQL com NO_BACKSLASH_ESCAPES a barra invertida é um carácter normal, e um escape a mais alteraria o valor guardado. O MySQL comporta-se de outra forma por omissão, por isso convém passar uma lista com barras invertidas pelos parâmetros da consulta e não como texto.

Quantas linhas aguenta a ferramenta?

O processamento é linear, por isso centenas de milhares de linhas são tratadas numa fração de segundo. Para grandes volumes o recálculo automático durante a escrita é desligado — carregue em «Converter».

Os dados são enviados para um servidor?

Não. O ficheiro largado é lido localmente através da File API e a conversão corre no separador do navegador. Não há pedidos de rede — vê-se no separador Network das ferramentas de programador.

Uma lista de texto para array: PHP, JavaScript, Python, Perl, JSON, SQL

Cole uma coluna do Excel, o resultado de uma consulta SQL ou simplesmente uma lista com um valor por linha — e obtém um array pronto, com o escape correto para sete formatos. Tudo é calculado no seu navegador: a lista nunca é enviada para lado nenhum nem é guardada.

A lista — um valor por linha Arraste para aqui um .txt ou .csv — o ficheiro é lido localmente. Uma coluna do Excel ou do Google Sheets pode ser colada diretamente.

Aspas

Nome da variável

Disposição

Sintaxe de array do PHP

Tratamento dos valores

Cortar os espaços nas extremidades Ignorar as linhas vazias Remover duplicados

Números sem aspas Sai sem aspas apenas o que é um número tanto na linguagem de destino como pelo valor: 42, -3.5. Uma referência 007, um número de telefone 0501234567, 1e5, 0x1F e um inteiro acima de 2⁵³ continuam a ser cadeias — caso contrário o próprio valor mudaria. Dividir a linha por vírgulas Desativado — a linha inteira torna-se um único elemento. Ativado — a linha é analisada segundo as regras de CSV: uma vírgula dentro de aspas continua a fazer parte do valor e as aspas duplicadas passam a uma só.

Serve também para TypeScript. const em vez de var: redefinir essa variável passa a ser um erro ainda antes da execução.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Cole uma lista acima — o array aparece aqui.

Os dados não saem do seu navegador — o cálculo é feito localmente, sem envio para um servidor.

O que a ferramenta faz exatamente com cada valor

Uma linha torna-se um elemento do array. Se for preciso, a linha pode ainda ser dividida por vírgulas segundo as regras de CSV — nesse caso a vírgula dentro de aspas continua a fazer parte do valor. Depois cada valor passa pelo escape, diferente para cada linguagem: PHP e Perl com aspas simples — são escapados exatamente dois carateres, a barra invertida e as próprias aspas. PHP com aspas duplas — junta-se o cifrão, senão $HOME no texto substituiria o valor de uma variável. Perl com aspas duplas — junta-se ainda a arroba, porque @list também é interpolado em Perl. JavaScript, TypeScript e Python — barra invertida, aspas e carateres de controlo como sequências de escape. JSON — estritamente segundo a RFC 8259, com os meios da própria linguagem. SQL — o apóstrofo é duplicado, como manda a norma. CSV — segundo a RFC 4180: só é colocado entre aspas o campo com vírgula, aspas ou espaço na extremidade. Um número sai sem aspas apenas quando continua a ser o mesmo número depois de passar por Number(). A referência 007, um telefone com zero à frente, 1e5, 0x1F e um inteiro acima de 2⁵³ não passam nessa verificação e continuam a ser cadeias.

Em que é que isto difere dos antigos conversores de listas

O arrayThis clássico verifica «isto é um número?» com isNaN() e não escapa nada além das próprias aspas. Daí quatro danos silenciosos que só se veem ao executar o código gerado: O caminho C:\Users\admin entre aspas duplas dá uma cadeia por fechar — ali a barra invertida inicia uma sequência de escape. Uma linha vazia passa no isNaN() como número e vai parar ao código como vírgula nua: ["a", , "b"]. A referência 007 passa a número octal em PHP e a erro de sintaxe no JavaScript estrito. Uma lista copiada do Windows arrasta atrás de cada valor um retorno de carro invisível. Aqui os quatro casos estão tratados, e a saída rotulada como Perl é mesmo Perl: uma lista entre parênteses e não a construção array(), que não existe em Perl.

Tudo para WordPress, desenvolvimento web — e não só

Uma lista de texto para array: PHP, JavaScript, Python, Perl, JSON, SQL

O que a ferramenta faz exatamente com cada valor

Em que é que isto difere dos antigos conversores de listas

Perguntas frequentes