Importar cabeceras de C con @cImport

Zig puede utilizar bibliotecas de C directamente, sin una capa de bindings independiente. El puente comienza con @cImport, que viene integrado.

@cImport ejecuta el compilador de C de Zig sobre un archivo C pequeño que usted describe y después expone cada declaración encontrada como un espacio de nombres normal de Zig.

Dentro de la llamada, indique las cabeceras mediante @cInclude. Cada una especifica una cabecera de C, igual que lo haría una línea de #include en C.

El resultado es un const normal de Zig. Accede a los nombres de C a través de él mediante la sintaxis de punto, exactamente como en cualquier otro espacio de nombres de una struct de Zig.

Coloque @cImport en el ámbito del archivo para que todo el módulo pueda utilizarlo. Se evalúa una vez durante la compilación, no durante la ejecución.

Un @cImport puede incorporar varias cabeceras. Añada más líneas de @cInclude y todas compartirán un único espacio de nombres combinado.

Use @cDefine antes de una inclusión para establecer una macro de C, igual que pasaría una opción -D a un compilador de C.

El @cUndef correspondiente elimina una macro antes de analizar las cabeceras, por si un valor predeterminado pudiera interferir.

Todo lo que está dentro de @cImport sucede en tiempo de compilación. Zig analiza el código C, lo traduce y le entrega declaraciones de Zig listas para usar.

Las macros de C que se expanden a valores simples se convierten en constantes utilizables en Zig, por lo que valores como EXIT_SUCCESS están disponibles directamente en el espacio de nombres.

Con un solo @cImport obtiene las funciones, los tipos y las constantes de toda una biblioteca de C, todos invocables desde código Zig idiomático.

Ha visto que @cImport junto con @cInclude convierte las cabeceras de C en un espacio de nombres de Zig durante la compilación, y le proporciona directamente las funciones y constantes de C. 🎯