---

Ⅰ. 插件描述

haystack.vim: fuzzy matching algorithm

Ⅱ. 基本信息

创建日期：  2015-02-04 使用用户：  12 Github星：  71 插件作者：  Tim Pope

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'tpope/haystack-vim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'tpope/haystack-vim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'tpope/haystack-vim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/tpope/vim-haystack

Ⅳ. 文档说明

# haystack.vim

Haystack provides a fuzzy matching algorithm for use by other Vim plugins.
It's based on [flx][] for Emacs but adapted to my own real world experience.
The algorithm gives priority to runs of consecutive letters and letters after
punctuation marks.

Usage

Haystack defines g:completion_filter with a reference to a function for
filtering a list of items based on a user provided query. Plugins can check
for this variable and use it if it exists. This level of indirection allows
for alternative matching algorithms without the need for plugins to be aware
of each one.

So far, out of the box support is included with [projectionist.vim][],
including dependent plugins like [rails.vim][].

Use with fuzzy finders

Here's a proof of concept for [ctrlp.vim][].

function! CtrlPMatch(items, str, limit, mmode, ispath, crfile, regex) abort
  let items = copy(a:items)
  if a:ispath
    call filter(items, 'v:val !=# a:crfile')
  endif
  return haystack#filter(items, a:str)
endfunction
let g:ctrlp_match_func = {'match': function('CtrlPMatch')}

Note that the algorithm is slow enough to feel sluggish with larger data sets.
You might consider a hybrid approach that uses a different algorithm above a
certain number of items.

License

Copyright © Tim Pope. Distributed under the same terms as Vim itself.
See :help license.