Onigmo 技术文档

1. 安装指南

Onigmo 是一个正则表达式库，支持多种平台。以下是不同平台的安装步骤：

Unix 和 Cygwin 平台

1. 执行 ./autogen.sh（如果 configure 文件不存在）。
2. 执行 ./configure。
3. 执行 make。
4. 执行 make install。

• 进行测试：执行 make test。
• 卸载：执行 make uninstall。
• 配置检查：执行 onigmo-config --cflags、onigmo-config --libs、onigmo-config --prefix 和 onigmo-config --exec-prefix。

Windows 64/32位平台（Visual C++）

执行 build_nmake.cmd。build_x64 或 build_x86 将用作工作/输出目录。

• onigmo_s.lib：静态链接库。

• onigmo.lib：动态链接库的导入库。

• onigmo.dll：动态链接库。

• 测试（ASCII/Shift_JIS/EUC-JP/Unicode）：执行 build_nmake.cmd test。需要与 Onigmo 同位数的 Python 来运行测试。

Windows 64/32位平台（MinGW）

执行 mingw32-make -f win32/Makefile.mingw。build_x86-64、build_i686 等将用作工作/输出目录。

• libonigmo.a：静态链接库。

• libonigmo.dll.a：动态链接库的导入库。

• onigmo.dll：动态链接库。

• 测试（ASCII/Shift_JIS/EUC-JP/Unicode）：执行 mingw32-make -f win32/Makefile.mingw test。需要与 Onigmo 同位数的 Python 来运行测试。

• 如果在 MSYS2 上使用 MinGW，也可以像 Unix 一样使用 ./configure 和 make。在这种情况下，DLL 名称将包含 API 版本号。例如：libonigmo-6.dll。

2. 项目使用说明

要使用 Onigmo，需要在程序中包含 onigmo.h 头文件。有关 Onigmo API 的详细信息，请参阅 doc/API。

如果希望在 onigmo.h 中禁用 UChar 类型的定义（等于 unsigned char），请定义 ONIG_ESCAPE_UCHAR_COLLISION，然后包含 onigmo.h。

如果希望在 onigmo.h 中禁用 regex_t 类型的定义，请定义 ONIG_ESCAPE_REGEX_T_COLLISION，然后包含 onigmo.h。

在 Unix 或 Cygwin 中的编译/链接命令行示例（假设前缀为 /usr/local）：

cc sample.c -L/usr/local/lib -lonigmo

如果希望在 Win32 上使用静态链接库（onigmo_s.lib），请在 C 编译器中添加 -DONIG_EXTERN=extern 选项。

3. 项目 API 使用文档

Onigmo 的 API 文档位于 doc/API 目录中。有关如何使用这些 API 的详细信息，请参考该文档。

4. 项目安装方式

Onigmo 的安装方式已在“安装指南”部分详细介绍，根据不同的操作系统平台，安装方式略有不同。请参照相应的步骤进行安装。