Info Catalog sed: Extended Commands sed: sed scripts

sed: Multiple commands syntax

 
 3.8 Multiple commands syntax
 ============================
 
 There are several methods to specify multiple commands in a 'sed'
 program.
 
    Using newlines is most natural when running a sed script from a file
 (using the '-f' option).
 
    On the command line, all 'sed' commands may be separated by newlines.
 Alternatively, you may specify each command as an argument to an '-e'
 option:
 
      $ seq 6 | sed '1d
      3d
      5d'
      2
      4
      6
 
      $ seq 6 | sed -e 1d -e 3d -e 5d
      2
      4
      6
 
    A semicolon (';') may be used to separate most simple commands:
 
      $ seq 6 | sed '1d;3d;5d'
      2
      4
      6
 
    The '{','}','b','t','T',':' commands can be separated with a
 semicolon (this is a non-portable GNU 'sed' extension).
 
      $ seq 4 | sed '{1d;3d}'
      2
      4
 
      $ seq 6 | sed '{1d;3d};5d'
      2
      4
      6
 
    Labels used in 'b','t','T',':' commands are read until a semicolon.
 Leading and trailing whitespace is ignored.  In the examples below the
 label is 'x'.  The first example works with GNU 'sed'.  The second is a
 portable equivalent.  For more information about branching and labels
 ⇒Branching and flow control.
 
      $ seq 3 | sed '/1/b x ; s/^/=/ ; :x ; 3d'
      1
      =2
 
      $ seq 3 | sed -e '/1/bx' -e 's/^/=/' -e ':x' -e '3d'
      1
      =2
 
 3.8.1 Commands Requiring a newline
 ----------------------------------
 
 The following commands cannot be separated by a semicolon and require a
 newline:
 
 'a','c','i' (append/change/insert)
 
      All characters following 'a','c','i' commands are taken as the text
      to append/change/insert.  Using a semicolon leads to undesirable
      results:
 
           $ seq 2 | sed '1aHello ; 2d'
           1
           Hello ; 2d
           2
 
      Separate the commands using '-e' or a newline:
 
           $ seq 2 | sed -e 1aHello -e 2d
           1
           Hello
 
           $ seq 2 | sed '1aHello
           2d'
           1
           Hello
 
      Note that specifying the text to add ('Hello') immediately after
      'a','c','i' is itself a GNU 'sed' extension.  A portable,
      POSIX-compliant alternative is:
 
           $ seq 2 | sed '1a\
           Hello
           2d'
           1
           Hello
 
 '#' (comment)
 
      All characters following '#' until the next newline are ignored.
 
           $ seq 3 | sed '# this is a comment ; 2d'
           1
           2
           3
 
 
           $ seq 3 | sed '# this is a comment
           2d'
           1
           3
 
 'r','R','w','W' (reading and writing files)
 
      The 'r','R','w','W' commands parse the filename until end of the
      line.  If whitespace, comments or semicolons are found, they will
      be included in the filename, leading to unexpected results:
 
           $ seq 2 | sed '1w hello.txt ; 2d'
           1
           2
 
           $ ls -log
           total 4
           -rw-rw-r-- 1 2 Jan 23 23:03 hello.txt ; 2d
 
           $ cat 'hello.txt ; 2d'
           1
 
      Note that 'sed' silently ignores read/write errors in
      'r','R','w','W' commands (such as missing files).  In the following
      example, 'sed' tries to read a file named ''hello.txt ; N''.  The
      file is missing, and the error is silently ignored:
 
           $ echo x | sed '1rhello.txt ; N'
           x
 
 'e' (command execution)
 
      Any characters following the 'e' command until the end of the line
      will be sent to the shell.  If whitespace, comments or semicolons
      are found, they will be included in the shell command, leading to
      unexpected results:
 
           $ echo a | sed '1e touch foo#bar'
           a
 
           $ ls -1
           foo#bar
 
           $ echo a | sed '1e touch foo ; s/a/b/'
           sh: 1: s/a/b/: not found
           a
 
 's///[we]' (substitute with 'e' or 'w' flags)
 
      In a substitution command, the 'w' flag writes the substitution
      result to a file, and the 'e' flag executes the subsitution result
      as a shell command.  As with the 'r/R/w/W/e' commands, these must
      be terminated with a newline.  If whitespace, comments or
      semicolons are found, they will be included in the shell command or
      filename, leading to unexpected results:
 
           $ echo a | sed 's/a/b/w1.txt#foo'
           b
 
           $ ls -1
           1.txt#foo
 

Info Catalog sed: Extended Commands sed: sed scripts