https://github.com/vim-scripts/ReplaceWithRegister

Replace text with the contents of a register.
https://github.com/vim-scripts/ReplaceWithRegister

Last synced: 4 days ago
JSON representation

Replace text with the contents of a register.

• Host: GitHub
• URL: https://github.com/vim-scripts/ReplaceWithRegister
• Owner: vim-scripts
• Created: 2010-10-19T02:17:25.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2015-06-22T13:35:40.000Z (over 9 years ago)
• Last Synced: 2024-07-11T13:04:31.755Z (4 months ago)
• Language: VimL
• Homepage: http://www.vim.org/scripts/script.php?script_id=2703
• Size: 188 KB
• Stars: 310
• Watchers: 4
• Forks: 20
• Open Issues: 1
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        
This is a mirror of http://www.vim.org/scripts/script.php?script_id=2703

DESCRIPTION

Replacing an existing text with the contents of a register is a very common

task during editing. One typically first deletes the existing text via the

d, D or dd commands, then pastes the register with p or P. Most of

the time, the unnamed register is involved, with the following pitfall: If you

forget to delete into the black-hole register ("_), the replacement text is

overwritten!

This plugin offers a two-in-one command that replaces text covered by a

{motion}, entire line(s) or the current selection with the contents of a

register; the old text is deleted into the black-hole register, i.e. it's

gone. (But of course, the command can be easily undone.)

The replacement mode (characters or entire lines) is determined by the

replacement command / selection, not by the register contents. This avoids

surprises like when the replacement text was a linewise yank, but the

replacement is characterwise: In this case, no additional newline is inserted.

SEE ALSO

- ReplaceWithSameIndentRegister.vim (vimscript #5046) is a companion plugin

  for the special (but frequent) case of replacing lines while keeping the

  original indent.

- LineJugglerCommands.vim (vimscript #4465) provides a similar :Replace [["]x]

  Ex command.

RELATED WORKS

- regreplop.vim (vimscript #2702) provides an alternative implementation of

  the same idea.

- operator-replace (vimscript #2782) provides replacement of {motion} only,

  depends on another library of the author, and does not have a default

  mapping.

- Luc Hermitte has an elegant minimalistic visual-mode mapping in

  http://code.google.com/p/lh-vim/source/browse/misc/trunk/macros/repl-visual-no-reg-overwrite.vim

- EasyClip (https://github.com/svermeulen/vim-easyclip) changes the delete

  commands to stop yanking, introduces a new "m" command for cutting, and also

  provides an "s" substitution operator that pastes register contents over the

  moved-over text.

USAGE

[count]["x]gr{motion}   Replace {motion} text with the contents of register x.

                        Especially when using the unnamed register, this is

                        quicker than "_d{motion}P or "_c{motion}"

[count]["x]grr          Replace [count] lines with the contents of register x.

                        To replace from the cursor position to the end of the

                        line use ["x]gr$

{Visual}["x]gr          Replace the selection with the contents of register x.