WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

export — eine Modulschnittstelle bereitstellen

Das Schlüsselwort `export` kennzeichnet eine Modulschnittstelleneinheit, stellt Deklarationen Importern bereit oder exportiert einen Import erneut. `export module M;` allein exportiert nicht automatisch alle nachfolgenden Deklarationen.

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

Syntax

export module M;
export declaration
export { declarations }
export import M;

export module M; kennzeichnet eine Schnittstelleneinheit des benannten Moduls M. Dagegen beginnt module M; eine Implementierungseinheit. Die Kennzeichnung der Schnittstelle allein exportiert nicht jede darin enthaltene Deklaration.

export int f(); exportiert eine Funktionsdeklaration, während export { ... } exportierte Deklarationen gruppiert, ohne einen neuen Gültigkeitsbereich zu erzeugen. Ihre Namen können durch Namenssuche in einer Übersetzungseinheit gefunden werden, die das Modul importiert. Exportdeklarationen müssen sich auf Namensraumebene innerhalb einer Modulschnittstelleneinheit befinden; sie dürfen weder in einem unbenannten Namensraum noch in einem privaten Modulfragment stehen. export static int x; ist ungültig, weil der Name interne Bindung hat.

export import M; exportiert einen Import erneut: Es stellt die exportierte Schnittstelle von M auch den Importern des aktuellen Moduls bereit. Ein gewöhnliches import M; bewirkt diesen erneuten Export nicht. In der Deklarationsfolge der Moduleinheit müssen Importe, einschließlich erneut exportierter Importe, vor allen anderen Deklarationen dieser Folge stehen. Gibt es ein privates Modulfragment, gilt die Regel dort separat: Importe müssen vor allen anderen Deklarationen des Fragments stehen. Ein gewöhnlicher Import am Anfang des privaten Modulfragments kann daher auf Deklarationen der vorausgehenden Folge folgen.

Das Beispiel benötigt zwei separate Dateien. answer_value ist exportiert, sodass main.cpp die Funktion nach import answer; aufrufen kann. Die Quelle auf eel.is ist ein fortlaufend bearbeiteter Entwurf und keine eingefrorene C++23-Ausgabe; die Unterstützung von Modulen muss lokal überprüft werden.

Beispiele

// answer.cppm
export module answer;

export constexpr int answer_value() {
    return 42;
}

// main.cpp
#include <cstdio>
import answer;

int main() {
    std::printf("%d\n", answer_value());
}

Ergebnis

42

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