https://github.com/tommcdo/vim-exchange

Easy text exchange operator for Vim
https://github.com/tommcdo/vim-exchange

Last synced: 30 days ago
JSON representation

Easy text exchange operator for Vim

• Host: GitHub
• URL: https://github.com/tommcdo/vim-exchange
• Owner: tommcdo
• License: mit
• Created: 2013-12-05T15:29:16.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-01-21T00:28:23.000Z (11 months ago)
• Last Synced: 2024-08-03T22:16:45.612Z (4 months ago)
• Language: Vim Script
• Size: 68.4 KB
• Stars: 747
• Watchers: 12
• Forks: 23
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• writingvim - vim-exchange - two-regions-of-text-with-exchange-vim/) :+1: (plugins for writing)

README

        
exchange.vim

============

Easy text exchange operator for Vim.

Mappings

--------

`cx`

On the first use, define the first {motion} to exchange. On the second use,

define the second {motion} and perform the exchange.

`cxx`

Like `cx`, but use the current line.

`X`

Like `cx`, but for Visual mode.

`cxc`

Clear any {motion} pending for exchange.

### Some notes

* If you're using the same motion again (e.g. exchanging two words using

  `cxiw`), you can use `.` the second time.

* If one region is fully contained within the other, it will replace the

  containing region.

Example

-------

To exchange two words, place your cursor on the first word and type `cxiw`.

Then move to the second word and type `cxiw` again. Note: the {motion} used in

the first and second use of `cx` don't have to be the same.

More

----

Check out these other resources for more information:

* [Swapping two regions of text with exchange.vim][e65]

[e65]: http://vimcasts.org/episodes/swapping-two-regions-of-text-with-exchange-vim

Other text editors

------------------

Exchange.vim has been ported by third parties to work with Vim emulators in

other text editors.

* **Emacs**: [evil-exchange][emacs] by [Dewdrops][dd]

* **Atom**: [vim-mode-plus-exchange][atom] by [Dillon Kearns][dk]

* **Zsh**: [zsh-viexchange][zsh] by [Oliver Kiddle][ok]

* **IntelliJ**: [IdeaVim exchange extension][ij] by [Alexey Gerasimov][ft]

[emacs]: https://melpa.org/#/evil-exchange

[atom]: https://atom.io/packages/vim-mode-plus-exchange

[zsh]: https://github.com/okapia/zsh-viexchange

[ij]: https://github.com/JetBrains/ideavim/wiki/Emulated-plugins#exchange

[dd]: https://github.com/Dewdrops

[dk]: https://github.com/dillonkearns

[ok]: https://github.com/okapia

[ft]: https://github.com/fan-tom

Troubleshooting

---------------

More details and troubleshooting can be found in the [Wiki][wiki].

[wiki]: https://github.com/tommcdo/vim-exchange/wiki

Installation

------------

If you don't have a preferred installation method, I recommend

installing [pathogen.vim](https://github.com/tpope/vim-pathogen), and

then simply copy and paste:

    cd ~/.vim/bundle

    git clone git://github.com/tommcdo/vim-exchange.git

Once help tags have been generated, you can view the manual with

`:help exchange`.