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:
- Kontrakt sicherstellen: gültige, null-terminierte Strings; gültige Zeiger
unsafeauf das Innere beschränken und jedes Vorkommen mit// SAFETY:begründen- C-Fehler abfangen:
git_libgit2_init()liefert einenc_int-Status — deine Hülle wandelt ihn in einResultoderpanic!um - Sauber deinitialisieren:
Dropverwendet, 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?
⚠ Häufiger Fehler: Wer den
c_int-Rückgabewert vongit_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 einResultoder einpanic!übersetzen — genau dafür ist sie da.
✅ 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.