extern-Blöcke: C-Funktionen deklarieren
Lektion 3 von 7
Eine C-Funktion anmelden
Ein extern-Block deklariert Funktionen oder Variablen, die in einer anderen
Bibliothek definiert sind und mit dem finalen Rust-Programm gelinkt werden.
So sagst du Rust, wie C's strlen aussieht:
use std::ffi::c_char;
unsafe extern "C" {
fn strlen(s: *const c_char) -> usize;
// ^ C-Konventionen, ^ unsafe, weil sie einen Vertrag hat
}
extern "C"= es gelten C-Aufrufkonventionen- Die Funktion ist
unsafe: sie verlangt z. B. einen validen, null-terminierten String — ein Vertrag, den Rust nicht erzwingen kann.
In Rust aufrufen
use std::ffi::{c_char, CString};
fn main() {
let rust_str = "I'll be back";
let null_terminated = CString::new(rust_str).unwrap();
unsafe {
assert_eq!(strlen(null_terminated.as_ptr()), 12);
// → kein Panic: strlen zählt 12 Bytes bis zur Null-Terminierung
}
}
CString::new baut einen null-terminierten C-String. Es prüft auf
eingebettete Null-Bytes (die in C-Strings unmöglich sind) und fügt das
abschließende Null-Byte hinzu. Deshalb das unwrap.
Der Weg String → C
CString::new(str)erzeugt einen null-terminierten Besitz-String..as_ptr()liefert den*const c_char-Zeiger darauf.- Übergib ihn an die C-Funktion (innerhalb
unsafe).
Eine perfekte Umwandlung eines String (by value) übernimmt den vorhandenen
Buffer ohne Kopie; ein &str erfordert eine Heap-Kopie.
Übung: C-Funktion aufrufen
🧩 Übung m21-l3-e1
🔮 Vorhersage: Was passiert beim Ausführen?
⚠ Häufiger Fehler:
strlen(CString::new(s).unwrap().as_ptr())ist der Klassiker unter den FFI-Bugs: Das temporäreCStringwird am Ende des Ausdrucks sofort wieder freigegeben, der Zeiger zeigt auf toten Speicher — und alles kompiliert ohne jede Warnung. Immer erst binden (let c = CString::new(s)?;), dann den Zeiger imunsafe-Block übergeben.
✅ 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.