Eu tenho essa sequência de várias linhas (aspas incluídas):

abc'asdf"
$(dont-execute-this)
foo"bar"''

Como atribuiria a uma variável usando um heredoc no Bash?

Eu preciso preservar novas linhas.

Eu não quero escapar dos caracteres da string, isso seria irritante ...

Você pode evitar o uso inútil cate lidar melhor com aspas incompatíveis com isso:

$ read -r -d '' VAR <<'EOF'
abc'asdf"
$(dont-execute-this)
foo"bar"''
EOF

Se você não citar a variável ao repeti-la, as novas linhas serão perdidas. A citação preserva-os:

$ echo "$VAR"
abc'asdf"
$(dont-execute-this)
foo"bar"''

Se você deseja usar o recuo para facilitar a leitura no código-fonte, use um traço após os valores menores. O recuo deve ser feito usando apenas guias (sem espaços).

$ read -r -d '' VAR <<-'EOF'
    abc'asdf"
    $(dont-execute-this)
    foo"bar"''
    EOF
$ echo "$VAR"
abc'asdf"
$(dont-execute-this)
foo"bar"''

Se, em vez disso, você deseja preservar as guias no conteúdo da variável resultante, é necessário remover a guia IFS. O marcador de terminal para o documento aqui ( EOF) não deve ser recuado.

$ IFS='' read -r -d '' VAR <<'EOF'
    abc'asdf"
    $(dont-execute-this)
    foo"bar"''
EOF
$ echo "$VAR"
    abc'asdf"
    $(dont-execute-this)
    foo"bar"''

As guias podem ser inseridas na linha de comando pressionando Ctrl- V Tab. Se você estiver usando um editor, dependendo de qual, isso também poderá funcionar ou talvez seja necessário desativar o recurso que converte automaticamente as guias em espaços.

Use $ () para atribuir a saída de catsua variável assim:

VAR=$(cat <<'END_HEREDOC'
abc'asdf"
$(dont-execute-this)
foo"bar"''
END_HEREDOC
)

# this will echo variable with new lines intact
echo "$VAR"
# this will echo variable without new lines (changed to space character)
echo $VAR

Certifique-se de delimitar o início de END_HEREDOC com aspas simples.

Observe que o delimitador heredoc final END_HEREDOCdeve estar sozinho na linha (portanto, o parêntese final fica na próxima linha).

Obrigado @ephemientpela resposta.

essa é a variação do método Dennis, parece mais elegante nos scripts.

definição de função:

define(){ IFS='\n' read -r -d '' ${1} || true; }

uso:

define VAR <<'EOF'
abc'asdf"
$(dont-execute-this)
foo"bar"''
EOF

echo "$VAR"

desfrutar

O ps criou uma versão de 'loop de leitura' para shells que não suportam read -d. deve trabalhar com set -eue backticks desemparelhados , mas não foi testado muito bem:

define(){ o=; while IFS="\n" read -r a; do o="$o$a"'
'; done; eval "$1=\$o"; }

VAR=<<END
abc
END

não funciona porque você está redirecionando o stdin para algo que não se importa, ou seja, a atribuição

export A=`cat <<END
sdfsdf
sdfsdf
sdfsfds
END
` ; echo $A

funciona, mas há um tique lá dentro que pode impedi-lo de usar isso. Além disso, você deve realmente evitar o uso de backticks, é melhor usar a notação de substituição de comando $(..).

export A=$(cat <<END
sdfsdf
sdfsdf
sdfsfds
END
) ; echo $A

Ainda não existe uma solução que preserve novas linhas.

Isso não é verdade - você provavelmente está apenas sendo enganado pelo comportamento do eco:

echo $VAR # strips newlines

echo "$VAR" # preserves newlines

Ramificando a resposta de Neil , muitas vezes você não precisa de um var, pode usar uma função da mesma maneira que uma variável e é muito mais fácil ler do que as readsoluções embutidas ou baseadas em.

$ complex_message() {
  cat <<'EOF'
abc'asdf"
$(dont-execute-this)
foo"bar"''
EOF
}

$ echo "This is a $(complex_message)"
This is a abc'asdf"
$(dont-execute-this)
foo"bar"''

Uma matriz é uma variável, portanto, nesse caso, o mapfile funcionará

mapfile y <<z
abc'asdf"
$(dont-execute-this)
foo"bar"''
z

Então você pode imprimir assim

printf %s "${y[@]}"

atribuir um valor heredoc a uma variável

VAR="$(cat <<'VAREOF'
abc'asdf"
$(dont-execute-this)
foo"bar"''
VAREOF
)"

usado como argumento de um comando

echo "$(cat <<'SQLEOF'
xxx''xxx'xxx'xx  123123    123123
abc'asdf"
$(dont-execute-this)
foo"bar"''
SQLEOF
)"

Eu me vi tendo que ler uma string com NULL, então aqui está uma solução que lê tudo o que você joga nela. Embora se você realmente esteja lidando com NULL, precisará lidar com isso no nível hexadecimal.

$ cat> read.dd.sh

read.dd() {
     buf= 
     while read; do
        buf+=$REPLY
     done < <( dd bs=1 2>/dev/null | xxd -p )

     printf -v REPLY '%b' $( sed 's/../ \\\x&/g' <<< $buf )
}

Prova:

$ . read.dd.sh
$ read.dd < read.dd.sh
$ echo -n "$REPLY" > read.dd.sh.copy
$ diff read.dd.sh read.dd.sh.copy || echo "File are different"
$ 

Exemplo HEREDOC (com ^ J, ^ M, ^ I):

$ read.dd <<'HEREDOC'
>       (TAB)
>       (SPACES)
(^J)^M(^M)
> DONE
>
> HEREDOC

$ declare -p REPLY
declare -- REPLY="  (TAB)
      (SPACES)
(^M)
DONE

"

$ declare -p REPLY | xxd
0000000: 6465 636c 6172 6520 2d2d 2052 4550 4c59  declare -- REPLY
0000010: 3d22 0928 5441 4229 0a20 2020 2020 2028  =".(TAB).      (
0000020: 5350 4143 4553 290a 285e 4a29 0d28 5e4d  SPACES).(^J).(^M
0000030: 290a 444f 4e45 0a0a 220a                 ).DONE

Graças à resposta de dimo414 , isso mostra como sua ótima solução funciona e mostra que você também pode ter aspas e variáveis ​​no texto:

saída de exemplo

$ ./test.sh

The text from the example function is:
  Welcome dev: Would you "like" to know how many 'files' there are in /tmp?

  There are "      38" files in /tmp, according to the "wc" command

test.sh

#!/bin/bash

function text1()
{
  COUNT=$(\ls /tmp | wc -l)
cat <<EOF

  $1 Would you "like" to know how many 'files' there are in /tmp?

  There are "$COUNT" files in /tmp, according to the "wc" command

EOF
}

function main()
{
  OUT=$(text1 "Welcome dev:")
  echo "The text from the example function is: $OUT"
}

main

$TEST="ok"
read MYTEXT <<EOT
this bash trick
should preserve
newlines $TEST
long live perl
EOT
echo -e $MYTEXT