sponsor Vim development Vim logo go to HTTPS page Vim Book Ad

increment.vim : Subsitute a pattern with incremented values

 script karma  Rating 95/35, Downloaded by 2058    Comments, bugs, improvements  Vim wiki

created by
William Natter
script type
This is a handy plugin that makes easy replacing your favorite pattern ("@" by default) with a sequence of incremented values using the "Inc" command.


If you have a file that only contains the following lines:

   This is line @
   This is line @
   This is line @
   This is line @

By typing ":1,4Inc", you obtain:

   This is line 0
   This is line 1
   This is line 2
   This is line 3

Better yet...  With ":Inc i11 s4 pblah",

   This is a list: [blah, blah, blah, blah, blah, blah, blah]


   This is a list: [4, 15, 26, 37, 48, 59, 70]

You can also repeat the same value several times.  Consider:

      addr@: begin value@ = offset@+incr@; end
      addr@: begin value@ = offset@+incr@; end
      addr@: begin value@ = offset@+incr@; end

After ":%Inc r4", you obtain:

      addr0: begin value0 = offset0+incr0; end
      addr1: begin value1 = offset1+incr1; end
      addr2: begin value2 = offset2+incr2; end

I have just added support for bases and right alignment.  You just have to specify the width of your alignment:

   `define MEM_ADD0 @
   `define MEM_ADD1 @
   `define MEM_ADD2 @
   `define MEM_ADD3 @

becomes, after running ":%Inc w3 i128 f0":

   `define MEM_ADD0 000
   `define MEM_ADD1 128
   `define MEM_ADD2 256
   `define MEM_ADD3 384

or, after running ":%Inc w3 i128 f0 h":

   `define MEM_ADD0 000
   `define MEM_ADD1 080
   `define MEM_ADD2 100
   `define MEM_ADD3 180

Many thanks to Stanislas Sitar (vimscript #145), Ely Schoenfeld (vimscript #1199), Charles E Campbell's (vimtip #150, vimscript #670) and Neil Bird (vimscript #189).

Note: I need to merge with Ely's version, and to update the documentation.  Sorry if this causes any inconvenience in the meantime.

Happy Vimming!
install details
Download "increment.tar.gz" and put it in your user ".vim" or "vimfiles" directory.  For *nix, type:

gunzip -c increment.tar.gz | tar xvf -

This will populate a "doc" directory with an "increment.txt" file, and a "plugin" directory with an "increment.vim" file.

For other operating systems, I'm sorry: I don't use them...  I believe "gzip" should know how to deal with that file.

Rating scripts is only available on the HTTPS page

script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
increment.vim 1.1 2007-08-21 7.0 William Natter Added support for hexadecimal and octal bases, and for right-alignment
increment.tar.gz 1.0 2003-12-04 6.0 William Natter Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
SourceForge.net Logo