Adicionar prefixo em cada linha

Uma ferramenta para adicionar prefixo a cada linha transforma um colar bruto de código, corpo de e-mail, notas ou checklist em um bloco marcado de forma uniforme que você pode colocar em tickets, revisões e documentação. Informe qualquer string não vazia de uma ou várias linhas mais o prefixo desejado no início de cada linha—opções comuns incluem barra dupla e espaço para comentários JavaScript, cerquilha e espaço para shell ou Python, maior-que e espaço para citações no estilo e-mail, ou dois espaços e um traço para listas indentadas. A ferramenta normaliza quebras de Windows e Mac clássico, divide em cada quebra de linha e antepõe o prefixo a cada segmento, inclusive linhas interiores vazias, de modo que a forma do documento permanece estável.

Como funciona prefixar cada linha

Prefixar linhas é um dos padrões mais antigos de edição em massa em programação e escrita técnica: cada linha visual recebe o mesmo marcador inicial para que se possa comentar um bloco inteiro, citar uma mensagem ou marcar uma lista sem clicar linha a linha em um editor. Esta capacidade implementa essa regra cotidiana sobre texto simples em vez de documentos rich-text ou multi-cursores de IDE.

Primeiro a entrada é verificada: text ausente, um valor que não é string, ou uma string vazia após aparar espaços é rejeitado para que colagens em branco nunca pareçam sucesso. As quebras são normalizadas de modo que Windows CRLF, Mac clássico CR e Unix LF se tornam uma única forma LF antes da divisão. O divisor então quebra a string em cada LF; cada segmento resultante—incluindo segmentos vazios entre quebras consecutivas—é uma linha e recebe o mesmo prefixo no início.

O conteúdo interior de cada linha permanece inalterado: só o começo da linha é modificado. Quando você precisar de números sequenciais em vez de um marcador fixo, use uma capacidade de numeração de linhas; quando precisar remover espaços das bordas das linhas, use uma ferramenta de trim por linha. Esta página trata apenas de antepor uma string escolhida a cada linha de texto simples.

Dicas práticas, limites e quando usar esta ferramenta

Use esta capacidade quando a intenção de busca for adicionar prefixo a cada linha, antepor texto às linhas, comentar um bloco de código ou citar cada linha de um e-mail. Cole um trecho de código e defina prefix como barra dupla e espaço para comentá-lo em uma nota de revisão; use cerquilha e espaço para scripts de shell; use maior-que e espaço para transformar uma resposta colada em uma citação em bloco; use dois espaços e um traço para transformar linhas simples em marcador de lista aninhada.

Tenha em mente quebras finais intencionais: um LF final cria um último segmento vazio que ainda recebe o prefixo, o que coincide com a forma como muitos editores tratam quebras de fim de arquivo. Linhas individuais extremamente longas ainda contam como uma linha cada; a ferramenta não quebra por largura de caracteres. Origem HTML e Markdown é prefixada como strings brutas; remova a marcação primeiro se quiser apenas linhas de prosa visíveis.

Esta página não é um numerador sequencial de linhas, nem um trimmer por linha, nem um motor de localizar e substituir, nem um multi-cursor completo de IDE. Prefira numeração de linhas quando revisores precisem citar índices exatos; prefira trim por linha quando o problema for espaços iniciais irregulares; prefira esta capacidade quando cada linha precisar do mesmo marcador fixo.

Ao ensinar estilo de código, prefixe o mesmo trecho duas vezes com marcadores diferentes para que os aprendizes vejam como a sintaxe de comentários difere entre linguagens enquanto a transformação permanece estável.