Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

export — udostępnianie interfejsu modułu

Słowo kluczowe `export` oznacza jednostkę interfejsu modułu, udostępnia deklaracje importerom lub reeksportuje import. Samo `export module M;` nie eksportuje automatycznie wszystkich późniejszych deklaracji.

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

Składnia

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

export module M; oznacza jednostkę interfejsu nazwanego modułu M. Natomiast module M; rozpoczyna jednostkę implementacji. Samo oznaczenie interfejsu nie eksportuje wszystkich znajdujących się w nim deklaracji.

export int f(); eksportuje deklarację funkcji, a export { ... } grupuje eksportowane deklaracje bez tworzenia nowego zakresu. Ich nazwy mogą być odnajdywane przez wyszukiwanie nazw w jednostce importującej moduł. Deklaracje eksportujące muszą znajdować się w zakresie przestrzeni nazw, w obrębie jednostki interfejsu; nie mogą występować w nienazwanej przestrzeni nazw ani prywatnym fragmencie modułu. export static int x; jest niepoprawne, ponieważ nazwa ma wiązanie wewnętrzne.

export import M; reeksportuje import: udostępnia eksportowany interfejs M także importerom bieżącego modułu. Zwykłe import M; nie zapewnia takiego reeksportu. W sekwencji deklaracji jednostki modułu importy, w tym reeksportowane, muszą poprzedzać pozostałe deklaracje w tej samej sekwencji. W prywatnym fragmencie modułu, jeśli występuje, obowiązuje osobna reguła: importy muszą poprzedzać pozostałe deklaracje tego fragmentu. Zwykły import na początku prywatnego fragmentu może więc wystąpić po deklaracjach z poprzedzającej go sekwencji.

Przykład wymaga dwóch osobnych plików. answer_value jest eksportowane, więc main.cpp może wywołać tę funkcję po import answer;. Źródło na eel.is jest rozwijanym szkicem, a nie zamrożonym wydaniem C++23; przykład wymaga lokalnej weryfikacji obsługi modułów.

Przykłady

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

Wynik

42

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

Źródła