Cscope的使用(领略Vim + Cscope的强大魅力)
1、Cscope介绍
Cscope是类似于ctags一样的工具,但可以认为她是ctags的增强版,因为她比ctags能够做更多的事。在Vim中,通过cscope的查询,跳转到指定的地方就像跳转到任何标签;她能够保存标签栈,所以通过合适的键盘映射绑定,你能够在函数向后或向前跳转,就像通常使用的tags一样。
首次使用Cscope时,他会根据源文件生成符号数据库。然后在以后的使用中,cscope只是在源文件有改动或源文件列表不同时才会重建数据库。当在重建数据库时,未改动过的文件对应的数据库信息会从旧的数据库中拷贝过来,所以会使重建数据库快于一开始的新建数据库。
当你在命令行下调用cscope时,你会获得一个全屏选择窗口,能够使你查询特定的内容。然而,一旦你查询的有匹配,那么就会用你默认的编辑器来编辑该源文件,但是你不能够简单的使用Ctrl+]或者:tag命令来从一个标签跳转到另一个标签。
Vim中的cscope接口是通过以命令行形式调用完成的,然后解析查询返回的结果。最终的结果就是cscope查询结果就像通常的tags一样,这样你就可以自由跳转,就像在使用通常的tags(用ctrl+]或者:tag跳转)。
2、Cscope相关命令
所有的cscope命令都是通过向主cscope命令”:cscope”传递参数选项。她最短的缩写是”:cs”。”:scscope”命令也做同样的事情并且同时会横向分隔窗口(简称:”scs”)。
可用的缩写有:
add :增加一个新的cscope数据库/链接库
使用方法:
:cs add {file|dir} [pre-path] [flags]
其中:
[pre-path] 就是以-p选项传递给cscope的文件路径,是以相对路径表示的文件
前加上的path,这样你不要切换到你数据库文件所在的目录也可以使用它了。
[flags] 你想传递给cscope的额外旗标
实例:
:cscope add /root/code/vimtest/ftpd
:cscope add /project/vim/cscope.out /usr/local/vim
:cscope add cscope.out /usr/local/vim –C
find :查询cscope。所有的cscope查询选项都可用除了数字5(“修改这个匹配模式”)。
使用方法:
:cs find {querytype} {name}
其中:
{querytype} 即相对应于实际的cscope行接口数字,同时也相对应于nvi命令:
0或者s —— 查找这个C符号
1或者g —— 查找这个定义
2或者d —— 查找被这个函数调用的函数(们)
3或者c —— 查找调用这个函数的函数(们)
4或者t —— 查找这个字符串
6或者e —— 查找这个egrep匹配模式
7或者f —— 查找这个文件
8或者i —— 查找#include这个文件的文件(们)
实例:(#号后为注释)
:cscope find c ftpd_send_resp # 查找所有调用这个函数的函数(们)
:cscope find 3 ftpd_send_resp # 和上面结果一样
:cscope find 0 FTPD_CHECK_LOGIN # 查找FTPD_CHECK_LOGIN这个符号
执行结果如下:
Cscope tag: FTPD_CHECK_LOGIN
# line filename / context / line
1 19 ftpd.h <<GLOBAL>>
#define FTPD_CHECK_LOGIN() \
2 648 ftpd.c <<ftpd_do_pwd>>
FTPD_CHECK_LOGIN();
3 661 ftpd.c <<ftpd_do_cwd>>
FTPD_CHECK_LOGIN();
4 799 ftpd.c <<ftpd_do_list>>
FTPD_CHECK_LOGIN();
5 856 ftpd.c <<ftpd_do_nlst>>
FTPD_CHECK_LOGIN();
6 931 ftpd.c <<ftpd_do_syst>>
FTPD_CHECK_LOGIN();
7 943 ftpd.c <<ftpd_do_size>>
FTPD_CHECK_LOGIN();
8 960 ftpd.c <<ftpd_do_dele>>
FTPD_CHECK_LOGIN();
9 981 ftpd.c <<ftpd_do_pasv>>
FTPD_CHECK_LOGIN();
Enter nr of choice (<CR> to abort):
然后输入最前面的序列号即可。
help :显示一个简短的摘要。
使用方法:
:cs help
kill :杀掉一个cscope链接(或者杀掉所有的cscope链接)
使用方法:
:cs kill {num|partial_name}
为了杀掉一个cscope链接,那么链接数字或者一个部分名称必须被指定。部分名
称可以简单的是cscope数据库文件路径的一部分。要特别小心使用部分路径杀死一个cscope链接。
假如指定的链接数字为-1,那么所有的cscope链接都会被杀掉。
reset:重新初始化所有的cscope链接。
使用方法:
:cs reset
show:显示cscope的链接
使用方法:
:cs show
假如你在使用cscope的同时也使用ctags,|:cstag|可以允许你在跳转之前指定从一个或另一个中查找。例如,你可以选择首先从cscope数据库中查找,然后再查找你的tags文件(由ctags生成)。上述执行的顺序取决于|csto|的值。
|:cstag|当从cscope数据库中查找标识符时等同于“:cs find g”。
|:cstag|当从你的tags文件中查找标识符时等同于“|:tjump|”。