CKTIS / C++
module — Moduldeklarationen
`module` legt fest, ob eine Übersetzungseinheit zu einem benannten Modul gehört, oder beginnt ein Modulfragment. Unterscheide `export module M;`, `module M;` und `import M;`: Sie deklarieren jeweils eine Schnittstelle, eine Implementierung und die Verwendung eines Moduls.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
export module M;
module M;
export module M:Part;
module M:Part;
module;
module :private;module wird in der Modulsyntax als Schlüsselwort erkannt, anders als etwa int, das immer als Schlüsselwort gilt. export module M; beginnt die primäre Schnittstelleneinheit, während module M; eine Implementierungseinheit beginnt. Ein benanntes Modul hat genau eine primäre Schnittstelleneinheit. Ein Modul ist kein Namensraum: Der Name M allein erzeugt keinen Qualifizierer M::.
export module M:Part; deklariert eine Schnittstellenpartition, module M:Part; eine Implementierungspartition. Partitionen können nur innerhalb desselben Moduls importiert werden. Code, der die Schnittstelle verwendet, schreibt import M;, nicht module M;. Deklarationen, die Importern für die Namenssuche zur Verfügung stehen sollen, werden mit export markiert; durch den Import eines benannten Moduls werden dessen Makros nicht verfügbar.
module; beginnt vor der Deklaration des benannten Moduls ein globales Modulfragment, das sich zum Einbinden herkömmlicher Header eignet. module :private; beginnt ein privates Fragment, dessen Deklarationen für Importer nicht erreichbar sind. Es ist nur in der primären Schnittstelleneinheit zulässig; ein Modul mit einem solchen Fragment darf keine weiteren Moduleinheiten haben.
Das Beispiel besteht aus zwei getrennten Dateien. answer exportiert die Funktion value, und main.cpp prüft das Ergebnis zur Compilezeit und zur Laufzeit. Beim Build muss die kompilierte Schnittstelle dem Importer zur Verfügung stehen; es reicht nicht unbedingt, den zusammengefügten Text zu kompilieren. Dieser Eintrag bezieht sich auf C++23; die angegebene Website enthält einen sich weiterentwickelnden Arbeitsentwurf, keine abgeschlossene C++23-Ausgabe. Ein Compiler-Flag im Repository belegt nicht den Betrieb in einer Produktionsumgebung.
Beispiele
// answer.cppm
export module answer;
export constexpr int value() { return 42; }
// main.cpp
import answer;
static_assert(value() == 42);
int main() {
return value() == 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.