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

Sichere Hüllen um FFI bauen

Lektion 5 von 7

Das Muster: roh ist innerlich, sicher von außen

Rohe FFI-Calls sind unsafe und mühsam. Die Kunst liegt darin, sie in einem sicheren Interface einzukapseln: Das Innere ist unsafe, die öffentliche API ist safe und bietet einen Vertrag.

struct Rechner;

impl Rechner {
    // SAFETY: libc::strlen ist gültig, weil wir null-terminiert übergeben.
    fn textlaenge(text: &str) -> usize {
        let c = std::ffi::CString::new(text).expect("kein \\0 erlaubt");
        unsafe { strlen(c.as_ptr()) }
        // → textlaenge("hallo") ergibt 5
    }
}

Von außen ruft man Rechner::textlaenge("hallo") — sicher, ohne unsafe, und mit garantierter korrekter Nutzung.

Der Vertrag von Hüll-Funktionen

Eine sichere Hüll-Funktion muss:

  1. Kontrakt sicherstellen: gültige, null-terminierte Strings; gültige Zeiger
  2. unsafe auf das Innere beschränken und jedes Vorkommen mit // SAFETY: begründen
  3. C-Fehler abfangen: git_libgit2_init() liefert einen c_int-Status — deine Hülle wandelt ihn in ein Result oder panic! um
  4. Sauber deinitialisieren: Drop verwendet, um z. B. git_libgit2_shutdown() automatisch zu rufen

FFI eingrenzen wie Unsafe

Die gleiche Strategie wie in Modul 20: kleine Mengen Unsafe hinter sicheren Interfaces verstecken. So bleibt der Aufrufer-Code vollständig sicher, und alle unangenehmen Verträge (Zeiger, Null-Terminierung, C-Statuscodes) liegen an einer klar markierten Stelle.

Übung: Sichere Hülle für abs

🧩 Übung m21-l5-e1

🔮 Vorhersage: Was passiert beim Ausführen?

Editor wird geladen…
KI-Tutor (sokratisch — keine Komplettlösungen)

⚠ Häufiger Fehler: Wer den c_int-Rückgabewert von git_libgit2_init() ignoriert, nimmt C seine einzige Fehlermeldung weg: Ein fehlgeschlagener Init sieht dann wie ein Erfolg aus, und der Dienst crasht erst viel später an einer unverdächtigen Stelle. Die Hülle soll den Statuscode prüfen und in ein Result oder ein panic! übersetzen — genau dafür ist sie da.

✅ 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.

Das Muster der sicheren FFI-Hülle: innen rohe unsafe FFI-Calls, außen eine API, die den Vertrag garantiert.
Jedes Vorkommen von unsafe in der Hülle wird mit einem -Kommentar begründet.
C-Fehler fängt die Hülle ab: Der c_int-Status von git_libgit2_init() wird in ein oder panic! umgewandelt.
0 von 3 richtig

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