Um heredoc é um redirecionamento que fornece um bloco de texto como entrada de um comando do shell. Você escreve o conteúdo na própria linha de comando ou no script, entre uma abertura com << e um delimitador de fechamento.
O shell lê as linhas até encontrar o delimitador sozinho em uma linha e entrega o bloco ao comando. Por padrão, o conteúdo vai para a entrada padrão, que é o canal pelo qual o comando lê a entrada. O delimitador encerra a leitura e fica fora do texto entregue.
Texto literal no Bash
O comando abaixo envia duas linhas ao cat, que lê a entrada e a imprime no terminal. As aspas em 'FIM' fazem o Bash preservar o texto do bloco:
cat <<'FIM'Primeira linha do exemplo.O texto $NOME permanece literal.FIMA saída contém as duas linhas intermediárias, incluindo $NOME exatamente como foi escrito. O fechamento usa apenas FIM, sem as aspas da abertura. Esse comando imprime o conteúdo, mas não grava um arquivo no projeto.
Quando as variáveis são substituídas
Com <<FIM, sem aspas no delimitador, o Bash expande as referências a variáveis e realiza expansões aritméticas no corpo. Assim, $NOME pode virar o valor da variável. A substituição de comandos também está ativa, por isso um trecho com $(comando) pode executar esse comando durante a preparação da entrada.
Para fornecer uma configuração que precisa conter $NOME como texto literal, use o delimitador entre aspas, como no exemplo. Esse cuidado controla o tratamento feito pelo Bash. A interpretação posterior ainda depende do programa que recebe a entrada.
Dúvidas frequentes
Perguntas frequentes sobre heredoc
- Por que o Bash continua esperando depois da última linha?
- Com `<<`, a linha de fechamento precisa conter apenas o delimitador, sem espaços no início ou no fim. As aspas usadas na abertura não fazem parte desse fechamento.
- O que muda ao usar `<<-`?
- O Bash remove as tabulações iniciais das linhas do bloco e do delimitador de fechamento. Espaços comuns não recebem esse tratamento, por isso a indentação precisa ser conferida.
- Um heredoc pode executar o texto recebido?
- O comando que recebe o bloco determina como interpretá-lo. O `cat` imprime o texto, mas um interpretador pode executá-lo. Além disso, um delimitador sem aspas permite substituições de comandos pelo próprio Bash.
Para continuar
Recursos relacionados
Documentação
GNU Bash: redirecionamentos
Detalha os here documents, a remoção de tabulações com `<<-` e as expansões permitidas quando o delimitador fica sem aspas.
Abrir recursoAplicação na formação
Developer Workspace
Os comandos de terminal podem receber texto multilinha, com tratamento explícito das expansões feitas pelo shell.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.