So far we've covered some of the most useful Vimscript commands, but what about all the stuff you do on a daily basis in normal mode? Can we somehow use all the knowledge we have from editing text in our scripting?
The answer is: "of course". We've seen the
normal command before, and now
it's time to revisit it in a bit more detail. Run the following command:
Vim will move your cursor to the last line in the current file, just like
G in normal mode would. Now run the following command:
Vim will move to the first line in the file (
gg) and then delete it (
normal command simply takes a sequence of keys and pretends they were
typed in normal mode. Seems simple enough.
Run the following command to map the
G key to something else:
:nnoremap G dd
G in normal mode will delete a line. Try this command:
Vim will delete the current line. The
normal command will take into account
any mappings that exist.
This means that we need something like the
nnoremap version of
normal, otherwise we'll never be able to use it since we can't know what keys
our users have mapped.
Luckily Vim has a
normal! command that does exactly this. Run this command:
This time Vim moves to the bottom of the file even though
G has been mapped.
When writing Vim scripts you should always use
normal!, and never use
normal. You can't trust what keys your users will have mapped in
If you play around with
normal! long enough you'll probably notice a problem.
Try the following command:
At first glance it may seem like this should perform a search for "foo", but
you'll see that it doesn't work. The problem is that
normal! doesn't parse
special character sequences like
In this case Vim thinks you wanted to search for the character sequence "f, o, o, left angle bracket, c, r, right angle bracket", and doesn't realize that you even pressed return to perform the search! We'll talk about how to get around this in the next chapter.
:help normal. The end of it will hint at the topic of the next chapter.
If you're not feeling up for a challenge, skip this section. If you are, good luck!
:help normal said about undo. Try to make a mapping that will
delete two lines but let you undo each deletion separately.
dddd is a good place to start.
You won't actually need
normal! for this (
nnoremap will suffice), but it
illustrates a good point: sometimes reading about one Vim command can spark an
interest in something unrelated.
If you've never used the
helpgrep command you'll probably need it now. Read
:help helpgrep. Pay attention to the parts about how to navigate between the
Don't worry about patterns yet, we're going to cover them soon. For now it's
enough to know that you can use something like
foo.*bar to find lines
containing that regex in the documentation.
helpgrep can be frustrating at times because you need to know
what words to search for before you can find them! I'll cut you some slack and
tell you that in this case you're looking for a way to break Vim's undo sequence
manually, so that the two deletes in your mapping can be undone separately.
In the future, be pragmatic. Sometimes Google is quicker and easier when you don't know exactly what you're after.