Llamar a funciones de C y enlazar

@cImport le proporciona las declaraciones, pero el código máquina real sigue estando en una biblioteca de C contra la que debe enlazar.

La mayoría de las llamadas a C necesitan la biblioteca estándar de C. Indique al sistema de compilación que enlace libc para que funciones como printf se resuelvan durante el enlazado.

Para una ejecución rápida, pase la opción manualmente. -lc enlaza libc al compilar directamente un único archivo.

Una vez enlazada, una función de C se llama igual que una de Zig. Escriba c.printf(...) y Zig se encarga de la convención de llamada.

Debe pasar argumentos que coincidan con la firma de C. Los tipos incorrectos producen un error de compilación, ya que Zig conoce el prototipo traducido.

Para otras bibliotecas, indique su nombre. linkSystemLibrary indica al enlazador que incluya algo como la biblioteca matemática.

El valor devuelto por una función de C llega como un valor normal de Zig del tipo traducido, listo para almacenarlo o comprobarlo.

C no tiene uniones de error, así que los fallos aparecen como códigos de retorno o como un errno establecido. Debe comprobarlos manualmente, al estilo de C.

Zig no hace ninguna conversión silenciosa de sus datos. Lo que pasa es lo que recibe C, lo que mantiene la llamada rápida y predecible.

En build.zig, vincula el enlazado al artefacto. El mismo paso exe que compila su código también registra sus bibliotecas.

Llamar a C siempre requiere importar y enlazar: incorpore las declaraciones y asegúrese de que los símbolos reales estén disponibles para el enlazador.

Piense en qué hace que una función de C se resuelva realmente.

Ha aprendido que llamar a C requiere tanto la importación como el enlazado, tras lo cual las funciones de C se invocan igual que las funciones nativas de Zig. 🎯