Day 65: 与C代码的无缝互操作

1. 引言：无缝的外部函数接口（FFI）

Zig的设计目标之一是成为比C更好的C，并与现有的C代码库实现无缝集成。这意味着Zig提供了强大的外部函数接口（FFI）能力，特别是与C的互操作性。与其他语言需要复杂的绑定生成器或手写包装代码不同，Zig可以直接导入C头文件并调用C函数，就像它们是原生的Zig代码一样。

这使得利用数十年来积累的庞大C库生态系统变得异常简单。

2. `@cImport` 和 `@cInclude`

Zig与C互操作的核心是@cImport内置函数。它指示编译器导入一个C头文件，并将其中的类型、函数、宏等翻译成Zig代码。

在build.zig中，你可以将C源文件和头文件添加到你的可执行文件或库中。然后，在Zig代码中使用@cImport。

// In your Zig code
const c = @cImport({
    // @cInclude将路径添加到C编译器的包含路径中
    @cInclude("stdio.h");
    @cInclude("math.h");
});

@cImport的结果是一个Zig结构体，其字段对应于C头文件中声明的所有公开API。

3. C类型与Zig类型的对应

Zig的编译器会自动处理大多数C类型到Zig类型的转换：

int -> c_int
double -> c_double
char* -> ?*c_char (一个可空的C字符串指针)
struct MyStruct -> 一个与C内存布局兼容的Zig struct

Zig提供了std.c模块，其中包含了所有标准的C类型别名，如c_int, c_void, size_t等。

4. 调用C函数

一旦你通过@cImport导入了C头文件，调用C函数就变得非常直接。你可以像访问结构体字段一样访问这些函数。

const std = @import("std");

// 导入C标准库
const c = @cImport({
    @cInclude("stdio.h");
    @cInclude("string.h");
});

pub fn main() void {
    // C字符串字面量以 `c"..."` 定义，它们是null结尾的
    const c_str = c"Hello from Zig, via C!\n";

    // 调用C的printf函数
    _ = c.printf(c_str);

    // 调用C的strlen函数
    const len = c.strlen(c_str);
    std.debug.print("Length according to C: {d}\n", .{len});
}

5. 示例：链接一个外部库（如zlib）

要在build.zig中链接一个系统库：

// In build.zig
// ...
exe.linkSystemLibrary("z"); // "z" 是 zlib 的库名

然后在Zig代码中导入并使用它：

const c = @cImport({
    @cInclude("zlib.h");
});

pub fn main() void {
    const version = c.zlibVersion();
    std.debug.print("Zlib version: %s\n", .{version});
}

6. 实践练习：使用C的数学库

导入math.h，并使用C的sin和cos函数来计算一个点的旋转。创建一个Point结构体{x: f64, y: f64}，并编写一个函数rotate(p: Point, angle_rad: f64) Point，使用c.sin和c.cos来实现旋转逻辑。

7. 常见问题

C的宏（Macros）如何处理？ Zig的C翻译器会尝试将简单的#define宏（如常量）转换为Zig的const变量。然而，对于复杂的函数式宏，翻译可能会失败或产生非预期的结果。在这种情况下，你可能需要手动将宏的逻辑用Zig重写。
ABI兼容性 ABI（Application Binary Interface）定义了函数调用、参数传递和内存布局的底层约定。Zig被设计为与C的ABI完全兼容，这是实现无缝互操作的基础。你无需担心调用约定或数据对齐等问题，编译器会为你处理好。
与C++的互操作性 Zig与C的互操作性非常好，但与C++的互操作性则非常有限。Zig不能直接@cImport C++头文件，因为C++有更复杂的特性，如类、模板、重载和名字修饰（name mangling）。与C++代码互操作的推荐方法是为C++库编写一个C风格的包装API（使用extern "C"），然后让Zig与这个C接口进行交互。

8. 总结：两个世界的优点

Zig与C的无缝互操作是其最强大的特性之一。它不仅让迁移现有的C项目变得容易，还打开了一个巨大的、经过实战检验的库生态系统的大门。通过将C代码视为一等公民，Zig让你可以在享受现代语言特性的同时，充分利用C生态系统的力量，真正做到了“集两家之长”。