# Changes: Multiple commands at once

Back to page

Tip 767 Printable Monobook Previous Next

created 2004 · complexity basic · author pim · version 6.0

You can execute more than one command by placing a | between two commands.

For example:

%s/htm/html/c | %s/JPEG/jpg/c | %s/GIF/gif/c


This example substitutes for htm, then moves on to JPEG, then GIF.

The second command (and subsequent commands) are only executed if the prior command succeeds.

This works for most commands, but some commands like :argdo or :autocmd see the '|' as one of their arguments. This allows commands such as :argdo, which execute a different Vim command, to execute a series of commands. See :help :\bar for the full list of such commands.

For example:

argdo %s/foo/bar/gc | w


Normally, Vim will complain if you haven't saved changes to a buffer before abandoning it, but by adding | w in the above example, you can actually write out each buffer after processing. Note that this command will, for each item in the arg list, do a :substitute and a :write. If :argdo didn't take '|' as an argument, it would instead run the :substitute on each item, then write the last item.

If you want to make a command chain including one of the commands listed at :help :\bar, you can still do so using the :execute command. For example, in order to chain a :normal command, you would need to do something like this:

:execute 'normal "ayiw' | echo @a


## References

Normally, you'd pass the range to each command, like the "%" in the first example. Theoretically, you could put the commands in a function, then :call that function, and it would be invoked once for each line of the range, but I doubt that's what you're after. You could use my CommandWithMutableRange plugin, though: :[range]ExecuteWithMutableRange command1 | command2 | command3 -- Inkarkat 10:12, October 9, 2010 (UTC)