While searching, you may want to operate on the text found by a search. Typically, you want to copy a search hit, or change it (delete the hit, and enter insert mode so you can type in new text). Often one of the standard commands can be used (for example, if you searched for a complete word, the command
cw may be sufficient to change it).
A more general approach comes from using a text object. From Vim 7.4,
gn can be used. In earlier versions of Vim,
//e can be used to repeat the last search (because no new search pattern was entered), with the
e search offset to move the cursor to the end of the search hit. :help search-offset
Vim 7.4 and laterEdit
- TODO: Finish!
After searching, typing
n searches forward from the current position to find the next match. Typing
gn does the same thing, and selects the match. Using
gn, the current match is found if the cursor is at a search hit.
If an operator is pending, typing
gn operates on the selected match. For example,
dgn would delete the next match, and
cgn would change the next match. After moving the cursor, for example by pressing
n to search again, use
. to repeat the last operation.
A search text object for older Vim 7.3 and earlierEdit
By defining the mappings below for
s, after searching you can:
ysto copy the search hit.
"+ysto copy the hit to the clipboard.
csto change the hit.
gUsto convert the hit to uppercase.
vsto visually select the hit. If you type another
syou will extend the selection to the end of the next hit.
For example, search for 'File' and change it to 'Data' (
cs = change search):
/File csData<Esc> " Sample to search: GetFileDir GetFileId GetFilePos MyFile BackupFile
n to find the next occurrence and press
. to repeat the change.
Put the following in your vimrc:
" Make a simple "search" text object. vnoremap <silent> s //e<C-r>=&selection=='exclusive'?'+1':''<CR><CR> \:<C-u>call histdel('search',-1)<Bar>let @/=histget('search',-1)<CR>gv omap s :normal vs<CR>
This tip implements a simple search text object identified as "s". When in visual mode,
s is mapped to find the end of the last search pattern (
//e). When in operator-pending mode (for example, after pressing
y in normal mode),
s is mapped to normal-mode
vs which starts visual mode (assuming
v has not been mapped) and invokes the
s visual-mode mapping.
<C-r>= evaluates the following expression which tests the
'selection' option. If exclusive selection is used, the result is
'+1', otherwise the result is an empty string. Accordingly, the visual-mode map becomes
//e. :help search-offset
The visual-mode mapping continues with
:<C-u> to enter the command line while removing the visual range automatically inserted by Vim. The
histdel function removes the last (
-1) item from the search history (
let statement assigns the previous search item to
@/ (the search register) so pressing
N will search for the next or previous instance.
In :help todo we see a plan for a future version of Vim:
- Add text object for current search pattern: "
a/" and "
i/". Makes it possible to turn text highlighted for
'hlsearch'into a Visual area.
This tip prefers the simple "s" for a search hit, with no attempt to implement "a" and "i" text objects. Instead, "s" selects from the current position to the end of the next search hit.
The default for visual mode in Vim is that you can press
s to change a selected area. Using the mapping suggested in this tip, you would no longer be able to press
s to change a visual area (use
The tip can be helpful to reduce distractions while editing because you can always press
ys to yank the hit, or
cs to change it (you don't have to think about an alternative method). However, the tip has several limitations:
.to repeat a change will change the same number of characters that were previously changed (so you can only repeat a change when the search hit is a fixed length).
- The text object fails when the search hit is a single character, and when search wraps around the end of the buffer.
- Suppose you use
:set selection=exclusiveand search for 'abc'. If you find 'abc' at the end of a line, operations such as
cswill include the line break.
Vim 7.4 introduces gn to visually select the search hit. HaiFengK 16:13, April 18, 2017 (UTC)