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.