Ed

ed(1) is a non-visual text editor. It remains a powerful utility for scripted in-place file manipulation.


Installation

Most modern systems do not offer ed(1). Instead ex(1), which is bundled within the vim package, is symlinked to ed(1). This will be pre-installed on any Linux or BSD operating system, as a POSIX utility.


Input Mode

ed(1) enters input mode after one the following commands has been given:

Exit input mode by giving a period (.) alone.


Examples

Insert a Line into a File

Shell scripts make it trivial to append to a file. There are excellent tools such as sed(1) for search/replacing text. But there isn't a trivial way to, for example, insert a new line of text into the Nth line of a file.

This script demonstrates how such a task could be automated in part.

# Inserts a new third line into the file,
# which sets `someYamlProperty` to `true` in a Markdown header of some file.
ed "$1" <<EOF
3i
someYamlProperty: true
.
w
EOF

Line Editing

This script will rewrite itself to echo a new message.

message=

#This function uses a heredoc to pass commands into `ed`.
#It works like this:
#  - `1c` targets the first line for changing. Everything entered in input mode will replace this line.
#  - `message="$1"` is being inserted. Note that shell variables are evaluated in a heredoc.
#  - `.` exits input mode
#  - `w` writes the edited file to disk
edScript() {
  ed -s "$(realpath -s $0)" <<EOF
1c
message="$1"
.
w
EOF
}

#If this script is given an arguments, the first argument is passed to the above function.
#Otherwise, the script just echoes "$message".
if [ $# -ge 1 ]; then
  edScript "$1"
else
  echo "$message"
fi


See also

GNU Ed manual

Ex Reference Manual, the BSD4.4 UNIX User's Supplementary Document (USD)

ed(1)

ed(1p)

sed


CategoryRicottone

Ed (last edited 2023-04-05 17:25:24 by DominicRicottone)