GIRL模块

每一个GIRL源文件构成一个GIRL模块。为了支持模块功能，GIRL语言提供了下述语句（斜体字表示 命令参数。出现在方括号内的内容为可选的命令参数）：

• module 模块名;

  module语句用于给出本GIRL文件的模块名。在一个GIRL文件中，必须出现一个，并且仅仅能够出现 一个module语句。

• version 主版本号[.次版本号[.末版本号]];

  version用于给出本模块的版本号。在一个GIRL文件中，必须出现一个，并且仅仅能够出现一个version 语句。如果末版本号不出现，则看作0。如果次版本号不出现，则看作0。

GIRL源文件经过编译器girlc编译后，将生成两个文件：.i.h、.i.c或.i.cpp。在GIRL源文件中可以 按照如下形式给出直接被插入由girlc生成的头文件和源文件的内容：

• 出现在"#{"和"#}"之间的内容，将被按照在GIRL源文件中出现的顺序插入由girl编译器输出的头文件中；
• 出现在"%{"和"%}"之间、或者出现在"%%{"和"%%}"之间的内容，将被按照在GIRL源文件中出现的顺序插 入由girl编译器输出的C/C++源文件中。其中，"%{"和"%}"表示希望GIRL按照C语言方式输出C源文件。"%%{" 和"%%}"表示希望GIRL按照C++语言方式输出C++源文件。在一个GIRL源文件中，只要出现了一个"%%{""%%}" 结构，就按照C++方式输出C++源文件。

为了与C/C++协同工作，GIRL模块必须能够被C/C++所访问。为此，GIRL提供了下列函数：

• girl *girl_initialize_module_模块名(void);

  该函数用于创建模块对象。为了避免C/C++函数名冲突，函数名中含有模块名。该函数将在由girlc生成 的头文件中给出说明。在引入了这个头文件之后就可以直接调用了。这种调用方式即适用于编译时连接的 GIRL模块，也适用于Plug-in。但前提是应用程序必须知道需要创建的模块名。

• ghandle girl_install_module(girl *pgirl);

  该函数用于安装给定模块。返回模块句柄。如果安装不成功，返回ghnull。

• ghandle girl_install_module_check(girl *pgirl,gint major_req,gint minor_req,gint micro_req);

  该函数在安装给定模块之前首先检测模块版本号。如果版本号不能满足要求，则立即退出并且给出出错信息。 给出错误信息的方式与girl_check_version的方式完全相同。

• gint girl_get_module_major_version(ghandle hgirl);

  该函数返回给定模块的主版本号。

• gint girl_get_module_minor_version(ghandle hgirl);

  该函数返回给定模块的次版本号。

• gint girl_get_module_micro_version(ghandle hgirl);

  该函数返回给定模块的末版本号。

• void girl_uninstall_module(ghandle hgirl);

  该函数用于卸载给定模块。girl_uninstall_module将根据需要自动释放模块占用的系统资源。

• ghandle girl_get_handle(const char *identifier);

  该函数用于获取指定标识符所对应的句柄。