WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

import — Module und Header-Units importieren

`import` macht die exportierte Schnittstelle eines benannten Moduls, eine Partition des aktuellen Moduls oder eine Header-Unit verfügbar. Anders als `#include` fügt es Inhalte nicht textuell ein; beim Import eines benannten Moduls werden keine Makros verfügbar.

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

Syntax

import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;

import arithmetic; importiert die Schnittstelle eines benannten Moduls: Seine exportierten Namen stehen nach der Importdeklaration für die Namenssuche zur Verfügung. Der Import erzeugt weder einen Namensraum noch fügt er eine Datei textuell ein. Ein Modulname ist kein Dateiname.

import :partition_name; importiert eine Partition desselben Moduls und darf erst nach dessen module-Deklaration stehen. import <header>; und import "header"; importieren eine Header-Unit, also eine separate Übersetzungseinheit, die aus einem importierbaren Header gebildet wird. Der direkte Import einer Header-Unit kann Makros verfügbar machen; der Import eines benannten Moduls nicht.

Eine Importdeklaration muss im globalen Namensraumbereich stehen, nicht innerhalb einer Funktion oder eines benannten Namensraums. In einer Moduleinheit müssen Importe in der jeweiligen Deklarationssequenz vor den übrigen Deklarationen stehen. export import module_name; exportiert den Import in einer Modulschnittstelle erneut und macht ihn für deren Nutzer verfügbar. Zyklische Abhängigkeiten zwischen Schnittstellen sind unzulässig.

Das Beispiel besteht aus zwei Dateien: arithmetic.cppm exportiert square, und main.cpp importiert das Modul und prüft das Ergebnis zur Compile-Zeit. Es gibt nichts aus und sollte mit Status 0 beendet werden. Compiler und Buildsystem müssen Module und ihre Abhängigkeiten unterstützen; ein C++23-Flag allein belegt weder einen erfolgreichen Build noch eine erfolgreiche Ausführung. Die angegebene Website enthält einen fortlaufend weiterentwickelten Arbeitsentwurf, nicht den endgültigen C++23-Text.

Beispiele

// arithmetic.cppm
export module arithmetic;
export constexpr int square(int x) { return x * x; }

// main.cpp
import arithmetic;
static_assert(square(6) == 36);
int main() {
    return square(6) == 36 ? 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