---

Ⅰ. 插件描述

Move cursor as you like.

Ⅱ. 基本信息

创建日期：  2014-02-01 使用用户：  1 Github星：  12 插件作者：  Masaaki Nakamura

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'machakann/patternjump'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'machakann/patternjump'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'machakann/patternjump'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/machakann/vim-patternjump

Ⅳ. 文档说明

vim-patternjump

Move cursor as you like.

introduction

Patternjump gives you a effective way to move cursor in various modes. The rules to move cursor can be easily optimized by using regular expression. In this introduction those rules defined by regular expression are called patterns. Numbers of patterns can be registered and cursor would be moved to the closest candidate in them. This plugin serves two keymappings. One searches candidates for forward direction, and the other searches them for backward direction.

Suppose that your cursor is on the first character of a line like this:

let foo = "bar"

If you define a pattern bar, of course, it matches with bar. Thus using the keymapping which searches candidates in forward direction, cursor will move on a word bar. Here I should say there are two types of patterns, head-patterns and tail-patterns. All the patterns should belong to either head or tail patterns, you can choose which when you register a new pattern. If bar belongs to head-patterns, cursor will move on b of bar. And if bar belongs to tail-patterns, cursor will move on r of bar.

---------->#    head-pattern
let foo = "bar"                         '#' represents cursor position
------------>#  tail-pattern

I guess you have found that the pattern bar seems like not useful. Alternatively, a pattern \<\h\k*\> is included in default patterns. This pattern matches with a independent word determined by the option 'iskeyword' in a source code. Therefore cursor will stop at let, foo, bar. I think they are the very what we want to correct when we review a source code in many cases.

#   #      #    head-pattern
let foo = "bar"                         '#' represents cursor position
  #   #      #  tail-pattern

The default mappings are assigned to <M-l> and <M-h>. <M-l> searches for candidates in forward direction and <M-h> searches for candidates in backward direction.

Normal mode

^\s*\zs\S, \<\h\k*\>, .$ belong to head-patterns in default. The first one matches with the first character of a line except for spaces, it is the equivalent to ^ command. \<\h\k*\> matches with a word. The last one is the last character of a line, but this pattern ignores the empty line. If the pattern $ is used, patternjump stops cursor even on a empty line.

Insert mode

^\s*\zs\S, ,, ), ], } belong to head-patterns and \<\h\k*\>, .$ belong to tail-patterns. In contrast to normal mode setting, \<\h\k*\> is a tail-pattern in insert mode. Because i_CTRL w is useful to delete a word in this case.

Visual mode

^\s*\zs\S, \<\h\k*\>, .$ belong to tail-patterns in default. The first and third patterns matches with a character, thus they work in same way as head-patterns in normal mode.

Operator-pending mode

Patternjump is also valid in operator-pending mode. You can define your motions by using regular expression. When you define your motions, exclusive or inclusive motion can be chosen. \<\h\k*\> is used as tail-pattern in the forward directed mapping and is used as head-pattern in the backward directed mapping in default.

Command-line mode

Patternjump can be used also in command-line mode. ^, , /, [A-Z], ,, ), ], }, $ belong to head-patterns in default.

Customization

The patterns can be defined to use a dictionary like this:

let s:patternjump_patterns = {
      \ '_' : {
      \   'i' : {
      \     'head' : ['^\s*\zs\S', ',', ')', ']', '}'],
      \     'tail' : ['\<\h\k*\>', '.$'],
      \     },
      \   'n' : {
      \     'head' : ['^\s*\zs\S', '\<\h\k*\>', '.$'],
      \     },
      \   'x' : {
      \     'tail' : ['^\s*\zs\S', '\<\h\k*\>', '.$'],
      \     },
      \   'o' : {
      \     'forward'  : {'tail_inclusive' : ['\<\h\k*\>']},
      \     'backward' : {'head_inclusive' : ['\<\h\k*\>']},
      \     },
      \   },
      \ '*' : {
      \   'c' : {
      \     'head' : ['^', ' ', '/', '[A-Z]', ',', ')', ']', '}', '$'],
      \     },
      \   },
      \ }

This example is the default patterns which is used in the case any pattern assignment does not exist. If you are interested in the customization of patterns, please refer doc/patternjump.txt. You can use independent patterns in different filetypes, modes (normal/visual/operator-pending/insert/command-line), direction (forward/backward). You would find detailed information about the customization of patterns.