Sed

Sed A Stream Editor

Sed is a "non-interactive" stream-oriented editor. It is stream-oriented because, like many UNIX programs, input flows through the program and is directed to standard output. (vi, for instance, is not stream-oriented. Nor are most DOS applications.) Input typically comes from a file but can be directed from the keyboard. Output goes to the terminal screen by default but can be captured in a file instead. Sed works by interpreting a script specifying the actions to be performed.

Examples

to change all instances for "OldString" with "NewString"

cat file.txt | sed ' {s/OldString/NewString/g} ' > newfile.txt

s = Substitute, g = Global

- HANDY ONE-LINERS FOR SED (Unix stream editor)              Apr. 26, 2004 compiled by Eric Pement - pemente[at]northpark[dot]edu       version 5.4 Latest version of this file is usually at: http://sed.sourceforge.net/sed1line.txt http://www.student.northpark.edu/pemente/sed/sed1line.txt This file is also available in Portuguese at: http://www.lrv.ufsc.br/wmaker/sed_ptBR.html

FILE SPACING:

sed G
 * 1) double space a file

sed '/^$/d;G'
 * 1) double space a file which already has blank lines in it. Output file
 * 2) should contain no more than one blank line between lines of text.

sed 'G;G'
 * 1) triple space a file

sed 'n;d'
 * 1) undo double-spacing (assumes even-numbered lines are always blank)

sed '/regex/{x;p;x;}'
 * 1) insert a blank line above every line which matches "regex"

sed '/regex/G'
 * 1) insert a blank line below every line which matches "regex"

sed '/regex/{x;p;x;G;}'
 * 1) insert a blank line above and below every line which matches "regex"

NUMBERING:

sed = filename | sed 'N;s/ /	/'
 * 1) number each line of a file (simple left alignment). Using a tab (see
 * 2) note on '	' at end of file) instead of space will preserve margins.

sed = filename | sed 'N; s/^/    /; s/ *(.{6,}) /1 /'
 * 1) number each line of a file (number on left, right-aligned)

sed '/./=' filename | sed '/./N; s/ / /'
 * 1) number each line of file, but only print numbers if line is not blank

sed -n '$='
 * 1) count lines (emulates "wc -l")

TEXT CONVERSION AND SUBSTITUTION:

sed 's/.$//'              # assumes that all lines end with CR/LF sed 's/^M$//'             # in bash/tcsh, press Ctrl-V then Ctrl-M sed 's/x0D$//'           # gsed 3.02.80, but top script is easier
 * 1) IN UNIX ENVIRONMENT: convert DOS newlines (CR/LF) to Unix format

sed "s/$/`echo -e \ `/"           # command line under ksh sed 's/$'"/`echo \ `/"            # command line under bash sed "s/$/`echo \ `/"              # command line under zsh sed 's/$/ /'                       # gsed 3.02.80
 * 1) IN UNIX ENVIRONMENT: convert Unix newlines (LF) to DOS format

sed "s/$//"                         # method 1 sed -n p                            # method 2
 * 1) IN DOS ENVIRONMENT: convert Unix newlines (LF) to DOS format

sed "s/ //" infile >outfile        # UnxUtils sed v4.0.7 or higher tr -d outfile           # GNU tr version 1.22 or higher
 * 1) IN DOS ENVIRONMENT: convert DOS newlines (CR/LF) to Unix format
 * 2) Can only be done with UnxUtils sed, version 4.0.7 or higher.
 * 3) Cannot be done with other DOS versions of sed. Use "tr" instead.

sed 's/^[ 	]*//'                   # see note on '	' at end of file
 * 1) delete leading whitespace (spaces, tabs) from front of each line
 * 2) aligns all text flush left

sed 's/[ 	]*$//'                   # see note on '	' at end of file
 * 1) delete trailing whitespace (spaces, tabs) from end of each line

sed 's/^[ 	]*//;s/[ 	]*$//'
 * 1) delete BOTH leading and trailing whitespace from each line

sed 's/^/    /'
 * 1) insert 5 blank spaces at beginning of each line (make page offset)

sed -e :a -e 's/^.{1,78}$/ &/;ta' # set at 78 plus 1 space
 * 1) align all text flush right on a 79-column width

sed -e :a -e 's/^.{1,77}$/ & /;ta'                     # method 1 sed -e :a -e 's/^.{1,77}$/ &/;ta' -e 's/( *)1/1/'  # method 2
 * 1) center all text in the middle of 79-column width. In method 1,
 * 2) spaces at the beginning of the line are significant, and trailing
 * 3) spaces are appended at the end of the line. In method 2, spaces at
 * 4) the beginning of the line are discarded in centering the line, and
 * 5) no trailing spaces appear at the end of lines.

sed 's/foo/bar/'            # replaces only 1st instance in a line sed 's/foo/bar/4'           # replaces only 4th instance in a line sed 's/foo/bar/g'           # replaces ALL instances in a line sed 's/(.*)foo(.*foo)/1bar2/' # replace the next-to-last case sed 's/(.*)foo/1bar/'           # replace only the last case
 * 1) substitute (find and replace) "foo" with "bar" on each line

sed '/baz/s/foo/bar/g'
 * 1) substitute "foo" with "bar" ONLY for lines which contain "baz"

sed '/baz/!s/foo/bar/g'
 * 1) substitute "foo" with "bar" EXCEPT for lines which contain "baz"

sed 's/scarlet/red/g;s/ruby/red/g;s/puce/red/g'  # most seds gsed 's/scarlet|ruby|puce/red/g'               # GNU sed only
 * 1) change "scarlet" or "ruby" or "puce" to "red"

sed '1!G;h;$!d'              # method 1 sed -n '1!G;h;$p'            # method 2
 * 1) reverse order of lines (emulates "tac")
 * 2) bug/feature in HHsed v1.5 causes blank lines to be deleted

sed '/ /!G;s/(.)(.* )/&21/;//D;s/.//'
 * 1) reverse each character on the line (emulates "rev")

sed '$!N;s/ / /'
 * 1) join pairs of lines side-by-side (like "paste")

sed -e :a -e '/\$/N; s/\ //; ta'
 * 1) if a line ends with a backslash, append the next line to it

sed -e :a -e '$!N;s/ =/ /;ta' -e 'P;D'
 * 1) if a line begins with an equal sign, append it to the previous line
 * 2) and replace the "=" with a single space

gsed ':a;s/B[0-9]{3}>/,&/;ta'                    # GNU sed sed -e :a -e 's/(.*[0-9])([0-9]{3})/1,2/;ta' # other seds
 * 1) add commas to numeric strings, changing "1234567" to "1,234,567"

gsed ':a;s/(^|[^0-9.])([0-9]+)([0-9]{3})/12,3/g;ta'
 * 1) add commas to numbers with decimal points and minus signs (GNU sed)

gsed '0~5G'                 # GNU sed only sed 'n;n;n;n;G;'            # other seds
 * 1) add a blank line every 5 lines (after lines 5, 10, 15, 20, etc.)

SELECTIVE PRINTING OF CERTAIN LINES:

sed 10q
 * 1) print first 10 lines of file (emulates behavior of "head")

sed q
 * 1) print first line of file (emulates "head -1")

sed -e :a -e '$q;N;11,$D;ba'
 * 1) print the last 10 lines of a file (emulates "tail")

sed '$!N;$!D'
 * 1) print the last 2 lines of a file (emulates "tail -2")

sed '$!d'                   # method 1 sed -n '$p'                 # method 2
 * 1) print the last line of a file (emulates "tail -1")

sed -n '/regexp/p'          # method 1 sed '/regexp/!d'            # method 2
 * 1) print only lines which match regular expression (emulates "grep")

sed -n '/regexp/!p'         # method 1, corresponds to above sed '/regexp/d'             # method 2, simpler syntax
 * 1) print only lines which do NOT match regexp (emulates "grep -v")

sed -n '/regexp/{g;1!p;};h'
 * 1) print the line immediately before a regexp, but not the line
 * 2) containing the regexp

sed -n '/regexp/{n;p;}'
 * 1) print the line immediately after a regexp, but not the line
 * 2) containing the regexp

sed -n -e '/regexp/{=;x;1!p;g;$!N;p;D;}' -e h
 * 1) print 1 line of context before and after regexp, with line number
 * 2) indicating where the regexp occurred (similar to "grep -A1 -B1")

sed '/AAA/!d; /BBB/!d; /CCC/!d'
 * 1) grep for AAA and BBB and CCC (in any order)

sed '/AAA.*BBB.*CCC/!d'
 * 1) grep for AAA and BBB and CCC (in that order)

sed -e '/AAA/b' -e '/BBB/b' -e '/CCC/b' -e d   # most seds gsed '/AAA|BBB|CCC/!d'                       # GNU sed only
 * 1) grep for AAA or BBB or CCC (emulates "egrep")

sed -e '/./{H;$!d;}' -e 'x;/AAA/!d;'
 * 1) print paragraph if it contains AAA (blank lines separate paragraphs)
 * 2) HHsed v1.5 must insert a 'G;' after 'x;' in the next 3 scripts below

sed -e '/./{H;$!d;}' -e 'x;/AAA/!d;/BBB/!d;/CCC/!d'
 * 1) print paragraph if it contains AAA and BBB and CCC (in any order)

sed -e '/./{H;$!d;}' -e 'x;/AAA/b' -e '/BBB/b' -e '/CCC/b' -e d gsed '/./{H;$!d;};x;/AAA|BBB|CCC/b;d'        # GNU sed only
 * 1) print paragraph if it contains AAA or BBB or CCC

sed -n '/^.{65}/p'
 * 1) print only lines of 65 characters or longer

sed -n '/^.{65}/!p'       # method 1, corresponds to above sed '/^.{65}/d'           # method 2, simpler syntax
 * 1) print only lines of less than 65 characters

sed -n '/regexp/,$p'
 * 1) print section of file from regular expression to end of file

sed -n '8,12p'              # method 1 sed '8,12!d'                # method 2
 * 1) print section of file based on line numbers (lines 8-12, inclusive)

sed -n '52p'                # method 1 sed '52!d'                  # method 2 sed '52q;d'                 # method 3, efficient on large files
 * 1) print line number 52

gsed -n '3~7p'              # GNU sed only sed -n '3,${p;n;n;n;n;n;n;}' # other seds
 * 1) beginning at line 3, print every 7th line

sed -n '/Iowa/,/Montana/p'            # case sensitive
 * 1) print section of file between two regular expressions (inclusive)

SELECTIVE DELETION OF CERTAIN LINES:

sed '/Iowa/,/Montana/d'
 * 1) print all of file EXCEPT section between 2 regular expressions

sed '$!N; /^(.*) 1$/!P; D'
 * 1) delete duplicate, consecutive lines from a file (emulates "uniq").
 * 2) First line in a set of duplicate lines is kept, rest are deleted.

sed -n 'G; s/ /&&/; /^([ -~]* ).* 1/d; s/ //; h; P'
 * 1) delete duplicate, nonconsecutive lines from a file. Beware not to
 * 2) overflow the buffer size of the hold space, or else use GNU sed.

sed '$!N; s/^(.*) 1$/1/; t; D'
 * 1) delete all lines except duplicate lines (emulates "uniq -d").

sed '1,10d'
 * 1) delete the first 10 lines of a file

sed '$d'
 * 1) delete the last line of a file

sed 'N;$!P;$!D;$d'
 * 1) delete the last 2 lines of a file

sed -e :a -e '$d;N;2,10ba' -e 'P;D'  # method 1 sed -n -e :a -e '1,10!{P;N;D;};N;ba' # method 2
 * 1) delete the last 10 lines of a file

gsed '0~8d'                          # GNU sed only sed 'n;n;n;n;n;n;n;d;'               # other seds
 * 1) delete every 8th line

sed '/^$/d'                          # method 1 sed '/./!d'                          # method 2
 * 1) delete ALL blank lines from a file (same as "grep '.' ")

sed '/./,/^$/!d'         # method 1, allows 0 blanks at top, 1 at EOF sed '/^$/N;/ $/D'       # method 2, allows 1 blank at top, 0 at EOF
 * 1) delete all CONSECUTIVE blank lines from file except the first; also
 * 2) deletes all blank lines from top and end of file (emulates "cat -s")

sed '/^$/N;/ $/N;//D'
 * 1) delete all CONSECUTIVE blank lines from file except the first 2:

sed '/./,$!d'
 * 1) delete all leading blank lines at top of file

sed -e :a -e '/^ sed -e :a -e '/^ $/ba'       # ditto, except for gsed 3.02*
 * 1) delete all trailing blank lines at end of file
 * $/{$d;N;ba' -e '}' # works on all seds
 * $/N;/

sed -n '/^$/{p;h;};/./{x;/./p;}'
 * 1) delete the last line of each paragraph

SPECIAL APPLICATIONS:

sed "s/.`echo \�`//g"   # double quotes required for Unix environment sed 's/.^H//g'            # in bash/tcsh, press Ctrl-V and then Ctrl-H sed 's/.x08//g'          # hex expression for sed v1.5
 * 1) remove nroff overstrikes (char, backspace) from man pages. The 'echo'
 * 2) command may need an -e switch if you use Unix System V or bash shell.

sed '/^$/q'               # deletes everything after first blank line
 * 1) get Usenet/e-mail message header

sed '1,/^$/d'             # deletes everything up to first blank line
 * 1) get Usenet/e-mail message body

sed '/^Subject: */!d; s///;q'
 * 1) get Subject header, but remove initial "Subject: " portion

sed '/^Reply-To:/q; /^From:/h; /./d;g;q'
 * 1) get return address header

sed 's/ *(.*)//; s/>.*//; s/.*[:<] *//'
 * 1) parse out the address proper. Pulls out the e-mail address by itself
 * 2) from the 1-line return address header (see preceding script)

sed 's/^/> /'
 * 1) add a leading angle bracket and space to each line (quote a message)

sed 's/^> //'
 * 1) delete leading angle bracket & space from each line (unquote a message)

sed -e :a -e 's/<[^>]*>//g;/</N;//ba'
 * 1) remove most HTML tags (accommodates multiple-line tags)

sed '/^end/,/^begin/d' file1 file2 ... fileX | uudecode  # vers. 1 sed '/^end/,/^begin/d' "$@" | uudecode                   # vers. 2
 * 1) extract multi-part uuencoded binaries, removing extraneous header
 * 2) info, so that only the uuencoded portion remains. Files passed to
 * 3) sed must be passed in the proper order. Version 1 can be entered
 * 4) from the command line; version 2 can be made into an executable
 * 5) Unix shell script. (Modified from a script by Rahul Dhesi.)

echo @echo off >zipup.bat dir /b *.txt | sed "s/^(.*).TXT/pkzip -mo 1 1.TXT/" >>zipup.bat
 * 1) zip up each .TXT file individually, deleting the source file and
 * 2) setting the name of each .ZIP file to the basename of the .TXT file
 * 3) (under DOS: the "dir /b" switch returns bare filenames in all caps).

TYPICAL USE: Sed takes one or more editing commands and applies all of them, in sequence, to each line of input. After all the commands have been applied to the first input line, that line is output and a second input line is taken for processing, and the cycle repeats. The preceding examples assume that input comes from the standard input device (i.e, the console, normally this will be piped input). One or more filenames can be appended to the command line if the input does not come from stdin. Output is sent to stdout (the screen). Thus:

cat filename | sed '10q'       # uses piped input sed '10q' filename             # same effect, avoids a useless "cat" sed '10q' filename > newfile   # redirects output to disk

For additional syntax instructions, including the way to apply editing commands from a disk file instead of the command line, consult "sed & awk, 2nd Edition," by Dale Dougherty and Arnold Robbins (O'Reilly, 1997; http://www.ora.com), "UNIX Text Processing," by Dale Dougherty and Tim O'Reilly (Hayden Books, 1987) or the tutorials by Mike Arst distributed in U-SEDIT2.ZIP (many sites). To fully exploit the power of sed, one must understand "regular expressions." For this, see "Mastering Regular Expressions" by Jeffrey Friedl (O'Reilly, 1997). The manual ("man") pages on Unix systems may be helpful (try "man sed", "man regexp", or the subsection on regular expressions in "man ed"), but man pages are notoriously difficult. They are not written to teach sed use or regexps to first-time users, but as a reference text for those already acquainted with these tools.

QUOTING SYNTAX: The preceding examples use single quotes ('...') instead of double quotes ("...") to enclose editing commands, since sed is typically used on a Unix platform. Single quotes prevent the Unix shell from intrepreting the dollar sign ($) and backquotes (`...`), which are expanded by the shell if they are enclosed in double quotes. Users of the "csh" shell and derivatives will also need to quote the exclamation mark (!) with the backslash (i.e., !) to properly run the examples listed above, even within single quotes. Versions of sed written for DOS invariably require double quotes ("...") instead of single quotes to enclose editing commands.

USE OF '	' IN SED SCRIPTS: For clarity in documentation, we have used the expression '	' to indicate a tab character (0x09) in the scripts. However, most versions of sed do not recognize the '	' abbreviation, so when typing these scripts from the command line, you should press the TAB key instead. '	' is supported as a regular expression metacharacter in awk, perl, and HHsed, sedmod, and GNU sed v3.02.80.

VERSIONS OF SED: Versions of sed do differ, and some slight syntax variation is to be expected. In particular, most do not support the use of labels (:name) or branch instructions (b,t) within editing commands, except at the end of those commands. We have used the syntax which will be portable to most users of sed, even though the popular GNU versions of sed allow a more succinct syntax. When the reader sees a fairly long command such as this:

sed -e '/AAA/b' -e '/BBB/b' -e '/CCC/b' -e d

it is heartening to know that GNU sed will let you reduce it to:

sed '/AAA/b;/BBB/b;/CCC/b;d'     # or even sed '/AAA|BBB|CCC/b;d'

In addition, remember that while many versions of sed accept a command like "/one/ s/RE1/RE2/", some do NOT allow "/one/! s/RE1/RE2/", which contains space before the 's'. Omit the space when typing the command.

OPTIMIZING FOR SPEED: If execution speed needs to be increased (due to large input files or slow processors or hard disks), substitution will be executed more quickly if the "find" expression is specified before giving the "s/.../.../" instruction. Thus:

sed 's/foo/bar/g' filename        # standard replace command sed '/foo/ s/foo/bar/g' filename  # executes more quickly sed '/foo/ s//bar/g' filename     # shorthand sed syntax

On line selection or deletion in which you only need to output lines from the first part of the file, a "quit" command (q) in the script will drastically reduce processing time for large files. Thus:

sed -n '45,50p' filename          # print line nos. 45-50 of a file sed -n '51q;45,50p' filename      # same, but executes much faster

If you have any additional scripts to contribute or if you find errors in this document, please send e-mail to the compiler. Indicate the version of sed you used, the operating system it was compiled for, and the nature of the problem. Various scripts in this file were written or contributed by:

Al Aab   # "seders" list moderator Edgar Allen              # various Yiorgos Adamopoulos  Dale Dougherty     # author of "sed & awk" Carlos Duarte    # author of "do it with sed" Eric Pement    # author of this document Ken Pizzini          # author of GNU sed v3.02 S.G. Ravenhall  # great de-html script Greg Ubben      # many contributions & much help -