Skip to content
Modul 21 — Foreign Functions: Rust & C zusammenbringen (FFI)
4

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 ein cargo:rustc-link-lib aus dem build.rs bricht erst das Linken ab: undefined reference to 'git_libgit2_init'. Den extern-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

0/3

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.

#[(name = "git2")] über dem extern-Block sagt dem Linker: Binde gegen libgit2.
Der extern-Block gibt Rust nur Name und Typ der Funktion — die stellt erst der Linker aus der C-Bibliothek bereit.
In der libgit2-Anbindung geben git_libgit2_init() und git_libgit2_shutdown() ihren Status als zurück (importiert aus std::ffi).
0 von 3 richtig

This site uses essential cookies for Stripe payments. No tracking cookies.