Numerar as linhas

Quando os números de linha são úteis

Compiladores e interpretadores indicam os problemas apenas por linha (“erro na linha 42”): numerar o trecho que você compartilha em um fórum, em um chat ou em uma revisão de código permite que quem está ajudando responda apontando a linha exata, sem contar à mão. A numeração de linhas também é padrão em documentos jurídicos e contratos, onde as cláusulas são citadas por linha, e em transcrições de entrevistas, onde as citações precisam ser referenciadas com precisão: pense em um depoimento judicial, em que cada linha do registro é numerada exatamente por esse motivo.

Qual formato escolher

O formato “1.” é o clássico das listas ordenadas e o mais legível em documentos; “1)” é comum em anotações e atas de reunião. O formato “001”, com zeros à esquerda, mantém as colunas perfeitamente alinhadas mesmo depois da linha 99 e é ideal para logs e listas que serão ordenadas alfabeticamente: sem os zeros, a linha 10 viria antes da 2. O número inicial personalizado é útil quando você cola um trecho de um arquivo maior: se o seu bloco começa na linha 120 do original, a numeração pode partir exatamente dali.

Os dois últimos formatos, o marcador “•” e o hífen “-”, não numeram nada: colocam o mesmo marcador na frente de cada linha, como em Linhas para lista com marcadores. As linhas vazias podem receber o marcador ou ficar vazias (e então não contam), e os marcadores que já estão no início das linhas podem ser removidos: marcadores de lista (“- ”, “• ”) sempre, números (“3. ”, “4. ”) quando sobem de um em um, como os que a ferramenta escreve. Assim, ao usá-la de novo sobre o próprio resultado, os números não se duplicam, e um ano no início de uma linha (“1969. ”) fica onde está. Só um espaço acompanha o marcador: a indentação do código permanece.