Vim for C Programmers

Vim is an extremely powerful editor with a user interface based on Bill Joy's almost 30-year-old vi, but with many new features. The features that make Vim so versatile also sometimes make it intimidating for beginners. This article attempts to level the learning curve with a specific focus on C programming.

A typical programmer's routine involves compiling and editing programs until the testing proves that the program correctly does the job it is supposed to do. Any mechanism that reduces the rigor of this cycle obviously makes any programmer's life easier. Vim does exactly that by integrating make with Vim in such a way that you don't have to leave the editor to compile and test the program. Running :make from inside of Vim does the job for you, provided a makefile is in the current directory.

You can change the directory from inside of Vim by running :cd. To verify where you are, use :pwd. In case you are using FreeBSD and want to invoke gmake instead of make from the command line, all you have to do is enter :set makeprg=gmake. Now say you want to give some parameters to make. If, for instance, you want to give CC=gcc296:

:set makeprg=gmake\ \CC=gcc296 
 

does the job.

Now comes the job of inspecting the errors, jumping to the appropriate line number in the source file and fixing them. If you want to display the line numbers in the source file, :se nu turns on this option, and :se nonu disables line number display.

Once you compile, Vim automatically takes you to the first line that is causing the error. To go to the next error; use :cn to take you to the next line number causing the error. :cfirst and :clast take you to the first error and the last error, respectively. Once you have fixed the errors, you can compile again. If you want to inspect the error list again, :clist displays it. Convenient, isn't it?

If you want to read some other source file, say foo.c, while fixing a particular error, simply type :e foo.c.

One shortcut provided by Vim to avoid typing too much to switch back to the previous file is to type :e # instead of typing the full path of the file. If you want to see all of the files you have opened in Vim at any point in time, you can use :ls or :buffers.

If you have a situation in which you have opened too many files and you want to close some of them, you can use :ls. It should display something like this:

2 #    "newcachain.c"                 line 5
3 %a   "cachain.c"                    line 1
 

If you want to close newcachain.c, :bd 2 or :bd newcachain.c does the job.

While browsing C code, you may have situations in which you want to skip multiple functions fast. You can use the ]] key combination for that while in command mode. If you want to browse backward in the file, the command is [[.

You also can use marks to bookmark certain cursor positions. You can use any lowercase alphabet character as a mark. For instance, say you want to mark line number 256 of the source and call it b. Simply go to that line, :256, and type mb in command mode. Vim never echoes what you type in command mode but silently executes the commands for you.

If you want to go to the previous position, typing '' (two single-quotation marks) takes you there. Typing 'a takes you to mark a and so on.

Especially when editing Makefiles, you may want to figure out which of the white spaces are tabs. You can type :se list, and whatever is displayed as ^I in blue are tabs. Another way to do that is to use /\t. This highlights the tabs in yellow.

Global searches and replaces are common tasks for programmers, and Vim provides good support for both. Simply type / in command mode, and you are taken to the searched keyword. If you prefer incremental searches, à la emacs, you can specify :se incsearch before you search. When you want to disable it, type :se nois.

Search and replace is a powerful tool in Vim. You can execute it only on a region that you selected using the v command, only between certain line numbers or only in rectangular regions selected with the Ctrl-V command.

Once you select your region or line number ranges, for example using :24,56 to select lines 24-56 (both inclusive), type s/foo/bar to replace all occurrences of the string foo with bar.

But, this command replaces only one instance per line. If you want to do this for multiple occurrences per line, type s/foo/bar/g. If you want to replace only some occurrences, you can use the "confirm" option with s/foo/bag/gc.