WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Module und Schnittstellengrenzen in C++

Ein benanntes Modul gruppiert Übersetzungseinheiten und macht Deklarationen über `export` verfügbar. Mit `import` können Clients seine Schnittstelle nutzen, ohne eine Datei textuell einzubinden. Die Modulgrenze trennt API und Implementierung, ist aber weder eine Sicherheitsgrenze noch ein eigener Namensraum.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

export module M;
export int answer();

// Separate implementation unit:
module M;
int answer() { return 42; }

// Separate importing translation unit:
import M;

Ein benanntes Modul ist eine Sammlung von Übersetzungseinheiten mit demselben Modulnamen. Genau eine davon ist die primäre Schnittstelleneinheit mit der Moduldeklaration export module M;. Dieser Deklaration kann ein durch module; eingeleitetes globales Modulfragment vorausgehen. Eine Implementierungseinheit, die keine Partition ist, wird mit module M; deklariert, eine Implementierungspartition mit module M:Part;. export macht Deklarationen für Clients verfügbar, und import M; ermöglicht die Namenssuche nach exportierten Namen. Ein Modul erzeugt selbst keinen Namensraum.

Die Schnittstellengrenze steuert die Verfügbarkeit von Namen, nicht die Geheimhaltung des Codes. Nicht exportierte Namen werden allein durch einen Import nicht zu einer gewöhnlichen Client-API; Deklarationen, die zum Interpretieren exportierter Entitäten benötigt werden, können für den Compiler dennoch erreichbar sein. Im Beispiel ruft der Client get_answer() auf, während helper() im unbenannten Namensraum der Implementierungseinheit verbleibt.

Partitionen wie M:Part teilen ein Modul in Einheiten auf, die mit import :Part; nur innerhalb desselben Moduls importiert werden können. Schnittstellenpartitionen müssen von der primären Schnittstelle direkt oder indirekt re-exportiert werden. export import N; exportiert eine Abhängigkeit erneut. Der Import eines benannten Moduls macht keine Makros verfügbar; import "header.h"; bezeichnet eine eigene Header-Unit, die Makros verfügbar machen kann.

Das Beispiel besteht aus drei separaten Dateien, nicht aus einer einzigen Quelldatei. Erstelle die Schnittstelle vor den davon abhängigen Einheiten und verknüpfe alle Objektdateien. Die Optionen zum Erstellen von Modulen müssen passend zum Compiler gewählt werden; ein C++23-Flag allein belegt keinen produktiven Betrieb. Die angegebene Quelle ist ein sich weiterentwickelnder Arbeitsentwurf und keine festgeschriebene C++23-Veröffentlichung.

Beispiele

// answer.cppm
export module answer;
export int get_answer();

// answer_impl.cpp
module answer;
namespace {
    int helper() { return 42; }
}
int get_answer() { return helper(); }

// main.cpp
import answer;

int main() {
    return get_answer() == 42 ? 0 : 1;
}

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen