Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

module — deklaracje modułów

`module` określa przynależność jednostki translacji do nazwanego modułu albo rozpoczyna fragment modułu. Rozróżniaj `export module M;`, `module M;` i `import M;`: deklarują one odpowiednio interfejs, implementację oraz użycie modułu.

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

Składnia

export module M;
module M;
export module M:Part;
module M:Part;
module;
module :private;

module jest rozpoznawane jako słowo kluczowe w kontekście składni modułów, a nie bezwarunkowo jak int. export module M; rozpoczyna główną jednostkę interfejsu, a module M; — jednostkę implementacji. Nazwany moduł ma dokładnie jedną główną jednostkę interfejsu. Moduł nie jest przestrzenią nazw: sama nazwa M nie tworzy kwalifikatora M::.

export module M:Part; deklaruje partycję interfejsu, a module M:Part; — partycję implementacji. Partycje można importować wyłącznie wewnątrz tego samego modułu. Kod korzystający z interfejsu zapisuje import M;, nie module M;. Deklaracje przeznaczone do wyszukiwania nazw przez importerów oznacza się export; import nazwanego modułu nie udostępnia jego makr.

module; rozpoczyna globalny fragment przed deklaracją nazwanego modułu, przydatny do dołączania tradycyjnych nagłówków. module :private; rozpoczyna fragment prywatny, którego deklaracje nie są osiągalne dla importerów. Jest dozwolony tylko w głównej jednostce interfejsu; moduł z takim fragmentem nie może mieć innych jednostek modułu.

Przykład obejmuje dwa osobne pliki. answer eksportuje funkcję value, a main.cpp sprawdza wynik podczas kompilacji i wykonania. Budowanie musi udostępnić skompilowany interfejs importerowi; nie zakładaj, że wystarczy skompilować połączony tekst. Zakres wpisu to C++23; wskazany serwis zawiera rozwijany szkic standardu, nie zamrożone wydanie C++23. Flaga kompilatora w repozytorium nie potwierdza działania w środowisku produkcyjnym.

Przykłady

// 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;
}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła