Numerar linhas

A linha em branco conta ou não conta?

É a primeira pergunta de quem numera uma lista, e a resposta certa depende do que você está fazendo — por isso aqui ela é uma escolha com nome, e não um comportamento escondido. As duas respostas existem há quarenta anos, cada uma num programa diferente do mesmo sistema: o nl numera só as linhas com texto e deixa a vazia passar sem número; o cat -n numera todas, inclusive as vazias. Um detalhe em que esta ferramenta escolhe diferente do nl: para ele, vazia é só a linha de comprimento zero — uma linha feita de espaços ele numera. Aqui ela conta como vazia, porque na tela as duas são a mesma coisa.

Quando você numera itens de uma lista — nomes, tarefas, cláusulas — quer o primeiro comportamento: a linha em branco separa blocos e não é item, e numerá-la faz uma lista de dez terminar em catorze. Quando você numera para citar depois — “veja da linha 12 à 15 da ata” — quer o segundo, porque o número precisa bater com a linha do arquivo, vazia ou não. A terceira opção, tirar a linha em branco da saída, é para a coluna de planilha que veio cheia de buracos.

O 9 e o 10 desalinham a lista inteira

Chegando na décima linha, o número ganha um algarismo e todo o texto depois dele anda uma casa para a direita. Numa lista de trinta itens isso é visível; numa de duzentas, com uma linha de três algarismos no meio, fica torto de um jeito que ninguém consegue apontar. A correção tem duas formas, e elas não servem para a mesma coisa:

• espaço na frente — 9. e 10.: emparelha de verdade só em fonte monoespaçada, como a do editor de código e a do resultado aqui em cima. Num documento do Word, com fonte comum, o espaço é mais estreito que o algarismo e o alinhamento não fecha;
• zero à esquerda — 09. e 10.: alinha em qualquer fonte, porque todos os números passam a ter a mesma quantidade de algarismos. É o formato de etiqueta, de protocolo, de número de sorteio e de nome de arquivo que precisa ficar em ordem.

A largura do enchimento sai da sua lista: uma lista de 9 itens não ganha espaço nenhum e uma de 120 ganha o necessário para o 120. Isso também é diferença em relação ao nl, que enche até seis casas por padrão e gasta cinco espaços numa lista de três itens.

Colar uma lista que já vem numerada

É o caso mais comum de todos: a numeração existe, está errada (pulou o 7, repetiu o 12, começou no lugar errado) e por isso a pessoa veio até aqui. Se a ferramenta só empurrasse números para a frente, o resultado seria 1. 1. Primeiro item — e é exatamente o que acontece na maioria delas.

Aqui a numeração antiga é trocada, e a caixa vem marcada. O que sustenta isso é a parte cuidadosa: a troca só acontece quando a lista inteira concorda — toda linha com texto tem marcador, todas usam o mesmo sinal, e os números sobem. Uma numeração torta que sobe fora de compasso (1, 2, 4, 5) é aceita, porque é justamente ela que a pessoa veio consertar.

E, quando não dá para ter certeza, nada é apagado e a ferramenta diz o motivo. Esse cuidado tem uma razão medida: entre os concorrentes desta busca, um deles remove numeração com três expressões aplicadas em sequência, e uma delas arranca qualquer número do começo da linha. Numa lista de carros, 1990 Fusca volta como Fusca, sem aviso nenhum. Aqui, 1990 Fusca / 1991 Gol não é numeração: são anos, e eles ficam.

Romano, letra e o teto de 3.999

Além do 1, 2, 3, dá para numerar em I, II, III — para cláusula de contrato e anexo — e em a, b, c — para alternativa de prova e subitem. Depois do z vem aa, e não ba: é a mesma contagem que nomeia coluna de planilha, e é onde a conta feita de cabeça costuma errar.

O sistema romano acaba em MMMCMXCIX — 3.999. Daí para cima a notação clássica precisa de um traço em cima da letra, que não é coisa que se cole num texto. Se a sua lista passar disso, a ferramenta numera tudo com algarismo comum e avisa, em vez de entregar metade em romano e metade não.

Numerar código sem estragar o recuo

Quem cola um trecho de programa aqui quer o número na frente e o recuo onde estava. Parece óbvio e não é: o código de uma das ferramentas que respondem essa busca em português foi lido linha a linha, e ele apara cada linha antes de numerar: devolve o programa inteiro encostado na margem, junto com as linhas em branco, que ela apaga sem dizer.

Aqui a linha volta letra por letra: espaço no começo, espaço no fim, tabulação, tudo. As opções decidem o que vem antes da linha, nunca o que a linha é. Se o que você quer é o texto limpo, isso é trabalho do limpar formatação.

Começar em outro número e contar de N em N

Duas coisas simples que quase nenhum site oferece e que o nl tem desde sempre. Começar em outro número serve para continuar uma lista que parou na página anterior — o item 48 vem depois do 47, não depois do 1. Contar de N em N serve para numerar de 5 em 5, de 10 em 10, ou para gerar códigos espaçados que ainda vão receber item no meio.

Para que se numera linha, afinal

Fora da lista de compras, o uso mais antigo é poder citar: ata de reunião, depoimento, minuta de contrato e parecer com as linhas numeradas permitem escrever “conforme as linhas 22 a 24” em vez de recopiar o trecho inteiro. Em documento de papel a numeração tinha ainda uma segunda função, a de mostrar que ninguém enfiou conteúdo entre parágrafos depois de assinado. Nenhuma norma brasileira obriga a fazer isso — é praxe, não regra, e a praxe varia de órgão para órgão.

No mundo do código, a numeração é o que faz o erro ser encontrável: “estourou na linha 42” só quer dizer alguma coisa se as duas pessoas estiverem olhando para a mesma contagem. E é por isso que a opção de numerar a linha em branco existe: nesse caso, o número precisa bater com o arquivo.

Ela mexe na ordem da minha lista?

Não. Sai na ordem em que você colou. Ordenar é escolha de critério e é outra ferramenta — ordem alfabética —, assim como tirar repetidas é do remover linhas duplicadas. Se você for usar as duas, ordene primeiro e numere depois: numerar antes gruda o número no item e ele viaja junto na ordenação.

Quantas linhas ela aguenta?

Muito mais do que se costuma colar. Medido aqui: mil linhas em 1 milésimo de segundo, dez mil em 5, cem mil em 53 e meio milhão de linhas — quase 14 MB de texto — em pouco menos de um quarto de segundo. Colar uma lista que já vinha numerada, que é o caso mais trabalhoso (a ferramenta precisa ler e conferir a numeração antiga antes de trocar), custou o mesmo: 50 milésimos para cem mil linhas. A lista na tela mostra as primeiras duas mil linhas para não travar o navegador desenhando; o botão copia todas.

O texto sai do meu computador?

Não. A conta inteira acontece dentro do seu navegador, enquanto você cola: não existe servidor recebendo o seu texto, não existe cadastro e nada fica guardado. Fechou a aba, acabou. É por isso que o resultado aparece sem botão de “enviar” e sem espera — e é o que permite colar aqui a minuta que você não colaria num site qualquer.