Bibliotheken linken: #[link]
Lektion 4 von 7
Eine externe Bibliothek anbinden
Stehen die Funktionen nicht in der Standard-C-Lib, sondern in einer
bestimmten Bibliothek, nennst du sie mit #[link] an der Spitze des
extern-Blocks. Beispiel libgit2:
use std::ffi::c_int;
#[link(name = "git2")]
unsafe extern "C" {
pub fn git_libgit2_init() -> c_int;
pub fn git_libgit2_shutdown() -> c_int;
}
fn main() {
unsafe {
git_libgit2_init();
git_libgit2_shutdown();
}
}
#[link(name = "git2")] sagt dem Linker: Binde gegen libgit2. Das Verhalten
hängt davon ab, wie libgit2 auf deinem System installiert ist.
Deklarieren ist nicht definieren
Der extern-Block gibt Rust Name und Typ der Funktion — die Definition
wird später beim Linken bereitgestellt. Genau das ermöglicht es, mit
Bibliotheken zu arbeiten, deren Quellcode du gar nicht in Rust neu schreibst:
du beschreibst nur die Schnittstelle.
⚠ Häufiger Fehler: Ohne
#[link(name = "git2")]oder eincargo:rustc-link-libaus dembuild.rsbricht erst das Linken ab:undefined reference to 'git_libgit2_init'. Denextern-Block selbst kompiliert Rust nämlich anstandslos — ob die Bibliothek existiert, prüft erst der Linker. Und der Name folgt der Link-Konvention: „git2“, nicht „libgit2.so“.
✅ Wichtige Erkenntnisse
Haken setzen, um deinen Lernfortschritt zu markieren:
Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.
Erinnerungstraining
Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.