---

Ⅰ. 插件描述

Easy swapping of text in Vim

Ⅱ. 基本信息

创建日期：  2010-09-23 使用用户：  14 Github星：  14 插件作者：  Dimitar Dimitrov

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'kurkale6ka/swap'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'kurkale6ka/swap'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'kurkale6ka/swap'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/kurkale6ka/vim-swap

Ⅳ. 文档说明

Swapping of text in Vim

A plugin which makes swapping of text in Vim easier

<h2>1. Visual mode</h2>

1.1 \x

First select some text ([] represents the highlighted area). Then press \x

[a ==   123] [  a == 123 ] [a==123]
      |            |           |
      V            V           V
123 ==   a     123 == a    123==a

Note: Your selection can be loose and include white spaces at both ends.

1.2 \cx

By default the plugin acts on comparison operators
You are however allowed to specify any pivot for the swapping.

First select some text. Then press \cx
You will be asked to give a pattern (% used here)

Just testing  %  a percentage as a pivot
                  |
                  V
a percentage as a pivot  %  Just testing

1.3 Multiple lines

You can also use V, v or ^v to select several lines (v used), then press \x

a == [123
user !~ unknown
0]!=#1
   |
   V
123 == a
unknown !~ user
1!=#0

<h2>2. Normal mode</h2>

Swap with WORD on the right \x

# indicates the cursor position in the examples below.

      #
zero one      a_longer_word three
         |
         V
zero a_longer_word      one three

Swap with WORD on the left \X

zero one two     three
let's have some more fun
  #      |
         V
zero one two     let's
three have some more fun

2.1 Repeat

This plugin integrates with Tim Pope's repeat plugin. It means that you can
use . (dot) to repeat any normal mode (for now) swap mapping you just used!

For more information see: http://github.com/tpope/vim-repeat

<h2>3. Supported operators</h2>

Comparison operators

===    !==     <>    ==#    !=#     >#
>=#     <#    <=#    =~#    !~#    ==?
!=?     >?    >=?     <?    <=?    =~?
!~?     ==     !=     >=     =~     <=
!~      ~=

Logical operators
&& ||

Assignment operators

+=     -=     *=     /=     %=     &=
|=     ^=    <<=    >>=

Scope operators
::

Pointer operators
->* -> .*

Bitwise operators
<< >>

Misc operators

>      <       =      +      -      *
/      %       &      |      ^      .
?      :       ,     '=     '<     '>
!<     !>

3.1 Custom operators

You can define your own operators by putting a similar line in your _vimrc_:

let g:swap_custom_ops = ['first_operator', 'second_operator', ...]

<h2>4. Custom mappings</h2>

You have the possibility to define your own custom mappings in your _vimrc_:

vmap <leader>x         <plug>SwapSwapOperands
vmap <leader><leader>x <plug>SwapSwapPivotOperands
nmap <leader>x         <plug>SwapSwapWithR_WORD
nmap <leader>X         <plug>SwapSwapWithL_WORD

Note: You can replace \x, \cx, \X with whatever you like.