gft4c

功能說(shuō)明

gft4c是一款為C語(yǔ)言開(kāi)發(fā)者提供的小工具。用來(lái)為C語(yǔ)言程序生成函數(shù)聲明列表。
比如，我們有c源碼文件如下：

spx_private?void?do_something1(int?varg1,int?varg2){
??//some?code?
}

spx_private?void?do_something2(int?varg1,int?varg2){
??//some?code?
}

spx_private?void?do_something3(int?varg1,int?varg2){
??//some?code?
}

spx_private?void?do_something4(int?varg1,int?varg2){
??//some?code?
}

spx_public?void?do_something5(int?varg1,int?varg2){
??//some?code?
}

spx_public?void?do_something6(int?varg1,int?varg2){
??//some?code?
}

spx_public?void?do_something7(int?varg1,int?varg2){
??//some?code?
}

然后根據(jù)c語(yǔ)言函數(shù)的特性，必須先聲明再使用。故一般我們都會(huì)在c文件的開(kāi)頭，最后一行#include的下面聲明函數(shù)，如上面的代碼，聲明函數(shù)列表如下：

spx_private?void?do_something1(int?varg1,int?varg2)；

spx_private?void?do_something2(int?varg1,int?varg2)；

spx_private?void?do_something3(int?varg1,int?varg2)；

spx_private?void?do_something4(int?varg1,int?varg2)；

而在h文件中，聲明公共的函數(shù)，如下：

spx_public?void?do_something5(int?varg1,int?varg2）；

spx_public?void?do_something6(int?varg1,int?varg2)；

spx_public?void?do_something7(int?varg1,int?varg2)；

在實(shí)際開(kāi)發(fā)中，一般函數(shù)聲明需要我們一個(gè)一個(gè)的重新寫(xiě)或者是從寫(xiě)好的函數(shù)簽名copy過(guò)去，再或者是到#include行下面寫(xiě)一行函數(shù)聲明，再到文件下方寫(xiě)函數(shù)定義。 不管使用哪種方法，都會(huì)顯得哼繁瑣。然后gft4c即為此而生。

gtf4c提供了開(kāi)發(fā)者安心寫(xiě)函數(shù)定義，然后使用gft4c命令GenFuncTitle即可在c文件的最后一個(gè)#include行下面生成函數(shù)聲明。

使用方法

1. 確保vim支持python，若不確定，請(qǐng)查看相關(guān)vim安裝時(shí)的擴(kuò)展；

2. 使用任一一種vim插件包管理器，將此插件安裝到本地；如使用vundle,在vimrc中請(qǐng)加入'Plugin 'xvhfeng/gft4c'';

3. 在vim中運(yùn)行明白BundleInstall，將自動(dòng)安裝此擴(kuò)展

4. 安裝完畢，重啟vim;

5. 打開(kāi)任一c文件，執(zhí)行命令:GenFuncTitle，即可看到在#include行下面已經(jīng)生成的函數(shù)聲明列表；

6. 注意：私有函數(shù)列表和公有函數(shù)列表都會(huì)在c文件中生成，因?yàn)?h文件不一定和c文件在同一目錄下，所以請(qǐng)開(kāi)發(fā)者執(zhí)行將公有函數(shù)列表copy到h文件中；

7. 生成函數(shù)列表的時(shí)候不會(huì)區(qū)分已經(jīng)存在的函數(shù)聲明，故需要注意；

配置

gft4c的配置只有2個(gè)，分別是g:spkx_private和g:spkx_public。這2個(gè)配置配置項(xiàng)如下：

1. g:spkx_private：配置函數(shù)為私有的起始標(biāo)志位，默認(rèn)為static或者是spx_private，不能為空；

2. g:spkx_public：配合函數(shù)為公有的起始標(biāo)志位，默認(rèn)為spx_public,不能為空； 說(shuō)明： spx_private和spx_public都是自定義的宏，定義分別如下：

#define?spx_private?static
#define?spx_public