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

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

  1. CString::new(str) erzeugt einen null-terminierten Besitz-String.
  2. .as_ptr() liefert den *const c_char-Zeiger darauf.
  3. Ü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?

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

⚠ Häufiger Fehler: strlen(CString::new(s).unwrap().as_ptr()) ist der Klassiker unter den FFI-Bugs: Das temporäre CString wird 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 im unsafe-Block übergeben.

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

Ein -Block deklariert Funktionen wie strlen für Rust: Name und Typ sind bekannt, gelinkt wird die Definition aus der anderen Bibliothek.
extern "C" bedeutet: es gelten die von C; die deklarierte Funktion ist unsafe, weil sie einen Vertrag hat, den Rust nicht erzwingen kann.
::new baut einen null-terminierten C-String: es prüft auf eingebettete Null-Bytes und fügt das abschließende Null-Byte hinzu.
0 von 3 richtig

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