Vim :s replace first N < g occurrences on a line

In vim, I sometimes have occasion to replace the first few occurrences of a match on a line, but not every one like g would. e.g.:

a a a a a

b b b a a

I know I could use :s/a/b/[enter]:[up][enter]:[up][enter], but that’s tedious enough at three repetitions, I have lines with potentially 10+ substitutions.
I’ve tried:
  • :s/a/b/3g: vim complained of trailing characters.
  • :s/a/b/3: changes the first occurrence on this and the following two lines.
  • 3:s/a/b: same as previous.
  • :s/a/b/g3: changes all occurrences on this and the next two lines.
  • :3s/a/b: changes the first occurrence on line 3.
  • :/a/,3/a/s/a/b: changes first occurrence on each line between the next a and the third line containing a in the file (prompting to reverse if necessary).
  • :/a/,/([^a]*a){3}/s/a/b/: changes the first occurrence on each line between this and the next with 3 as on it (and this wouldn’t have been easily extensible to a multi-character search).

And various other addressing patterns, none of which worked. I must say, I’ve learned a fair amount about the :s command trying to find an answer to this problem, but I still haven’t solved it.

Anyone know how to do this?

(bonus points for specific range, e.g. second through fourth occurrences)


Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

Building on the :s/pattern/replacement/gc idea from Samus_ (which seems to be the simplest way to ensure correct operation when pattern is contained within the replacement string), to replace the 2nd through 4th occurrences on a single line:

:call feedkeys("nyyyq") | s/pat/string/gc

feedkeys() is a function that stuffs the input string into the keyboard input queue. The point is to do the counting upfront so you don’t have to worry about losing count or getting interrupted.

For a more general case, to replace the Mth through Nth occurrences on a single line for N greater than or equal to a very large M:

:call feedkeys(repeat("n", M-1) . repeat("y", N-M+1) . "q") | s/pat/string/gc

Replace M and N with the values you want (you can even let vim do the trivial mental arithmetic if you don’t want to do it yourself). Note that . is VimL’s string concatenation operator. Obviously this only saves keystrokes for large M. If you use this functionality frequently, it may save you time to put the above in a custom command or function of some sort, as it is quite a bit to type.

Method 2

For the first question I would do:


The second is trickier, I don’t know a way to do it automatically but you can make vim prompt you on each match like this:

Then you reply “no” to the first n matches and “yes” to the others.

Method 3

a a a a a
a a a a a
a a a a a
a a a a a
a a a a a
a a a a a
a a a a a

:3,6g/^/let i=0 | while i<3 | s/a/b/ | let i+=1 | endwhile

a a a a a
a a a a a
b b b a a
b b b a a
b b b a a
b b b a a
a a a a a

Method 4

I think this might work, replace first, then repeat 2 times:

<a href="" class="__cf_email__" data-cfemail="e0d2a0">[email protected]</a>:

All methods was sourced from or, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

0 0 votes
Article Rating
Notify of
Inline Feedbacks
View all comments