40、深入了解gawk API变量与扩展开发

深入了解gawk API变量与扩展开发

1. API变量概述

API提供了两组变量。第一组变量提供有关API版本的信息，包括扩展编译时使用的API版本以及gawk编译时使用的API版本。第二组变量提供有关gawk调用方式的信息。

1.1 API版本常量和变量

API提供了“主”版本号和“次”版本号。在编译时，这些API版本以常量形式提供：
-GAWK_API_MAJOR_VERSION：API的主版本号。
-GAWK_API_MINOR_VERSION：API的次版本号。

当向API添加新函数时，次版本号会增加，新函数总是添加到API结构体的末尾。如果任何数据类型的大小或成员顺序发生变化，或者任何现有函数的签名发生变化，则主版本号会增加，并且次版本号会重置为零。

运行中的gawk的主版本号和次版本号作为只读常量整数包含在API结构体中：
-api->major_version：运行中的gawk的主版本号。
-api->minor_version：运行中的gawk的次版本号。

以下是检查API兼容性的示例代码：

if (api->major_version != GAWK_API_MAJOR_VERSION || api->minor_version < GAWK_API_MINOR_VERSION) { fprintf(stderr