149

I have

var="a b c"
for i in $var
do
   p=`echo -e $p'\n'$i`
done
echo $p

I want the last echo to print:

a
b
c

Notice that I want the variable p to contain newlines. How do I do that?

0

7 Answers 7

246

Summary

  1. Inserting a new line in the source code

     p="${var1}
     ${var2}"
     echo "${p}"
    
  2. Using $'\n' (only Bash and Z shell)

     p="${var1}"$'\n'"${var2}"
     echo "${p}"
    
  3. Using echo -e to convert \n to a new line

     p="${var1}\n${var2}"
     echo -e "${p}"
    

Details

  1. Inserting a new line in the source code

     var="a b c"
     for i in $var
     do
        p="$p
     $i"       # New line directly in the source code
     done
     echo "$p" # Double quotes required
               # But -e not required
    

    Avoid extra leading newline

     var="a b c"
     first_loop=1
     for i in $var
     do
        (( $first_loop )) &&  # "((...))" is Bash specific
        p="$i"            ||  # First -> Set
        p="$p
     $i"                      # After -> Append
        unset first_loop
     done
     echo "$p"                # No need -e
    

    Using a function

     embed_newline()
     {
        local p="$1"
        shift
        for i in "$@"
        do
           p="$p
     $i"                      # Append
        done
        echo "$p"             # No need -e
     }
    
     var="a b c"
     p=$( embed_newline $var )  # Do not use double quotes "$var"
     echo "$p"
    
  2. Using $'\n' (less portable)

    and interprets $'\n' as a new line.

     var="a b c"
     for i in $var
     do
        p="$p"$'\n'"$i"
     done
     echo "$p" # Double quotes required
               # But -e not required
    

    Avoid extra leading newline

     var="a b c"
     first_loop=1
     for i in $var
     do
        (( $first_loop )) &&  # "((...))" is bash specific
        p="$i"            ||  # First -> Set
        p="$p"$'\n'"$i"       # After -> Append
        unset first_loop
     done
     echo "$p"                # No need -e
    

    Using a function

     embed_newline()
     {
        local p="$1"
        shift
        for i in "$@"
        do
           p="$p"$'\n'"$i"    # Append
        done
        echo "$p"             # No need -e
     }
    
     var="a b c"
     p=$( embed_newline $var )  # Do not use double quotes "$var"
     echo "$p"
    
  3. Using echo -e to convert \n to a new line

     p="${var1}\n${var2}"
     echo -e "${p}"
    

    echo -e interprets the two characters "\n" as a new line.

     var="a b c"
     first_loop=true
     for i in $var
     do
        p="$p\n$i"            # Append
        unset first_loop
     done
     echo -e "$p"             # Use -e
    

    Avoid extra leading newline

     var="a b c"
     first_loop=1
     for i in $var
     do
        (( $first_loop )) &&  # "((...))" is bash specific
        p="$i"            ||  # First -> Set
        p="$p\n$i"            # After -> Append
        unset first_loop
     done
     echo -e "$p"             # Use -e
    

    Using a function

     embed_newline()
     {
        local p="$1"
        shift
        for i in "$@"
        do
           p="$p\n$i"         # Append
        done
        echo -e "$p"          # Use -e
     }
    
     var="a b c"
     p=$( embed_newline $var )  # Do not use double quotes "$var"
     echo "$p"
    

    ⚠ Inserting "\n" in a string is not enough to insert a new line: "\n" are just two characters.

The output is the same for all

a
b
c

Special thanks to contributors of this answer: kevinf, Gordon Davisson, l0b0, Dolda2000 and tripleee.


14
  • 21
    This doesn't actually embed newlines, it embeds \n, which the echo -e converts to newlines as it prints. Depending on your actual goal, this may or may not do the trick. Feb 4, 2012 at 17:52
  • Thank you very much @GordonDavisson. You are right! I have then updated my answer to insert a real new lines. To thank you I have upvoted a very good answer from you. Cheers. See you ;-)
    – oHo
    Feb 4, 2012 at 20:49
  • 1
    You've got a missing double quote; the third last code line should be p="$p"$'\n'"$i"
    – l0b0
    Feb 6, 2012 at 14:37
  • 1
    This prepends the output with an extra newline!
    – Kevin
    Mar 10, 2016 at 0:15
  • 1
    @kevinf Thank you very much, I have just updated (extended) this four-years-old answer! Cheers :-)
    – oHo
    Mar 10, 2016 at 6:37
34

The trivial solution is to put those newlines where you want them.

var="a
b
c"

Yes, that's an assignment wrapped over multiple lines.

However, you will need to double-quote the value when interpolating it, otherwise the shell will split it on whitespace, effectively turning each newline into a single space (and also expand any wildcards).

echo "$p"

Generally, you should double-quote all variable interpolations unless you specifically desire the behavior described above.

3
  • For more on proper quoting, see stackoverflow.com/questions/10067266/…
    – tripleee
    Nov 8, 2015 at 16:47
  • not working for me macOS Catalina, echo prints it all on one line echo -e or just echo. :(. Apr 7, 2020 at 22:41
  • 1
    @DeanHiller Again, the problem is with the quoting, not the assignment. You need echo "$p", not echo $p. (In zsh you don't even need the quoting. And probably never use echo -e; prefer printf for anything where basic echo is too crude.)
    – tripleee
    Apr 8, 2020 at 3:02
15

Try echo $'a\nb'.

If you want to store it in a variable and then use it with the newlines intact, you will have to quote your usage correctly:

var=$'a\nb\nc'
echo "$var"

Or, to fix your example program literally:

var="a b c"
for i in $var; do
    p="`echo -e "$p\\n$i"`"
done
echo "$p"
5
  • The $'variable' syntax is very convenient, but I don't believe it is portable to other shells.
    – tripleee
    Feb 4, 2012 at 10:33
  • 1
    @Dolda2000 Why do we have to escape \n ? Feb 4, 2012 at 16:27
  • @abc: That depends on which escape you mean. If you mean the final, echo "$p", it's because the shell would otherwise interpret the newlines as simple parameter separators, pass a, b and c to echo as three different parameters, and echo would then join them with spaces. When you quote $p, its exact contents are passed intact as one single parameter.
    – Dolda2000
    Feb 5, 2012 at 3:10
  • perfect, I think from info echo we can see all possible escaped chars to use like var=$'\n', thanks! May 11, 2015 at 1:29
  • Using echo -e inside backquotes is just crazy overcomplicated. If you have a newline in a variable nl=$'\n' you can just interpolate it p=$p$nl$i but even simpler, just put a literal newline in there in the first place.
    – tripleee
    Mar 28, 2022 at 5:12
14

There are three levels at which a newline could be inserted in a variable. Well ..., technically four, but the first two are just two ways to write the newline in code.

1.1. At creation.

The most basic is to create the variable with the newlines already. We write the variable value in code with the newlines already inserted.

$ var="a
> b
> c"
$ echo "$var"
a
b
c

Or, inside script code:

var="a
b
c"

Yes, that means writing Enter where needed in the code.

1.2. Create using shell quoting.

The sequence $' is a special shell expansion in Bash and Z shell.

var=$'a\nb\nc'

The line is parsed by the shell and expanded to « var="anewlinebnewlinec" », which is exactly what we want the variable var to be. That will not work on older shells.

2. Using shell expansions.

It is basically a command expansion with several commands:

  1. echo -e

     var="$( echo -e "a\nb\nc" )"
    
  2. The Bash and Z shell printf '%b'

     var="$( printf '%b' "a\nb\nc" )"
    
  3. The Bash printf -v

     printf -v var '%b' "a\nb\nc"
    
  4. Plain simple printf (works in most shells):

     var="$( printf 'a\nb\nc' )"
    

3. Using shell execution.

All the commands listed in the second option could be used to expand the value of a variable, if that var contains special characters.

So, all we need to do is get those values inside the variable and execute some command to show:

var="a\nb\nc"                 # var will contain the characters \n not a newline.

echo -e "$var"                # use echo.
printf "%b" "$var"            # use bash %b in printf.
printf "$var"                 # use plain printf.

Note that printf is somewhat unsafe if the variable value is controlled by an attacker.

9

There isn’t any need to use a for loop.

You can benefit from Bash parameter expansion functions:

var="a b c";
var=${var// /\\n};
echo -e $var
a
b
c

or just use tr:

var="a b c"
echo $var | tr " " "\n"
a
b
c
3
  • Re "for cycle": Do you mean "for loop"? Mar 25, 2022 at 15:09
  • yes, i mean for loop. Fixed my "typo" Mar 27, 2022 at 15:43
  • This is the simplest solution. But I used a pipe | instead since the space is often needed Oct 29, 2022 at 20:27
3

sed solution:

echo "a b c" | sed 's/ \+/\n/g'

Result:

a
b
c
-1
var="a b c"
for i in $var
do
   p=`echo -e "$p"'\n'$i`
done
echo "$p"

The solution was simply to protect the inserted newline with a "" during current iteration when variable substitution happens.

Not the answer you're looking for? Browse other questions tagged or ask your own question.