Chiamare funzioni C e collegare librerie

@cImport fornisce le dichiarazioni, ma il codice macchina effettivo si trova ancora in una libreria C a cui è necessario collegarsi.

La maggior parte delle chiamate C richiede la libreria standard C. Indichi al sistema di compilazione di collegare libc, così funzioni come printf vengono risolte durante il linking.

Per un'esecuzione rapida, passi personalmente il flag. -lc collega libc quando compila direttamente un singolo file.

Una volta effettuato il linking, una funzione C viene chiamata proprio come una funzione Zig. Scriva c.printf(...) e Zig gestirà la calling convention.

Deve passare argomenti compatibili con la signature C. I tipi errati causano un errore di compilazione, perché Zig conosce il prototipo tradotto.

Per le altre librerie, ne indichi il nome. linkSystemLibrary comunica al linker di includere, ad esempio, la libreria matematica.

Il valore restituito da una funzione C arriva come normale valore Zig del tipo tradotto, pronto per essere memorizzato o verificato.

C non dispone di error union, quindi gli errori si manifestano come codici di ritorno o come un errno impostato. Deve verificarli manualmente, secondo le modalità di C.

Zig non esegue alcuna conversione silenziosa dei dati. Ciò che passa è ciò che C riceve, mantenendo la chiamata efficiente e prevedibile.

In build.zig collega il linking all'artifact. Lo stesso passaggio exe che compila il codice registra anche le relative librerie.

Chiamare C richiede sempre import più link: importi le dichiarazioni, quindi si assicuri che i simboli reali siano disponibili al linker.

Rifletta su ciò che consente di risolvere effettivamente una funzione C.

Ha imparato che chiamare C richiede sia l'import sia il linking; dopo questi passaggi, le funzioni C vengono chiamate proprio come quelle native di Zig. 🎯