---

Ⅰ. 插件描述

Perfom non-cumulative multi-replace

Ⅱ. 基本信息

创建日期：  2010-01-21 使用用户：  1 Github星：  1 插件作者：  eiji kumiai

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin '/multi-replace'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle '/multi-replace'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug '/multi-replace'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/vim-scripts/Multi-Replace

Ⅳ. 文档说明

This script provides several functions to do multiple-string replacements.

The quick brown fox jumped over the six lazy dogs.
replace (dogs=fox, fox=dogs, x=ck) will give
The quick brown dogs jumped over the sick lazy fox.

Note that values are non-cumulative and longest-string-first, which is why
"x=ck" does not interfere with "dogs=fox" or "fox=dogs" replacements.
This can be used to specify exceptions in a replacement list.

Typical uses:

• Replacing variable names (eg code localization / code reuse)
• Replacing keywords with translations
• Generating code from a template
• Swapping keywords
    etc

Its main function is provided  by the MultiReplace function, which performs
non-cumulative replacements, replacing occurrences of hash keys with their corresponding hash values. Hash values may be arrays, in which case values are rotated across the lines containing the key value. Range of lines to replace may also be specified.

MultiReplace(dict, from, to)

Several functions that create the "dict" hash are also provided.

1) Read values from prompt
MultiReplace(ReadUserlist(), 1,  "$")

2) Replacement dictionary
A buffer may be also specified. A replacement list buffer will contain TAB separated pairs, with the string to find on the left and the string to replace with on the right. Such a replacement would be invoked with

MultiReplace(ReadDictionary("#"), 1, "$")

Where the "#" here refers to the alternate buffer:
ReadDictionary(buffer)

3) Look up table
A buffer containing delimiter-separated values my also be used. To use a csv that does not contain quote marks (ie, no quotes and no values with linebreaks), and replace all occurrences from column 1 with values from column 4:

MultiReplace(ReadColumns("#", ",", 1, 4), 1, "$")

ReadColumns is defined as
ReadColumns(buffer, sep, keycol, valcol)

Mappings
The following mappings are included in the file. This allows you to select a range of text, enter ",rem" and then enter "=" and specify find=replace pairs for a quick replacement.

:map ,rem :call MultiReplace("",1,"$")
:vmap ,rem :call MultiReplace("",line("'<"),line("'>"))