Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

import — importowanie modułów i jednostek nagłówkowych

`import` udostępnia eksportowany interfejs nazwanego modułu, partycję bieżącego modułu albo jednostkę nagłówkową. Nie jest tekstowym wklejaniem zawartości jak `#include`; import nazwanego modułu nie udostępnia makr.

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

Składnia

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

import arithmetic; importuje interfejs nazwanego modułu: jego eksportowane nazwy stają się dostępne przy wyszukiwaniu nazw po deklaracji importu. Import nie tworzy przestrzeni nazw ani nie oznacza tekstowego wklejenia pliku. Nazwa modułu nie jest nazwą pliku.

import :partition_name; importuje partycję tego samego modułu i może wystąpić dopiero po jego deklaracji module. import <header>; oraz import "header"; importują jednostkę nagłówkową, czyli odrębną jednostkę translacji utworzoną z importowalnego nagłówka. Bezpośredni import jednostki nagłówkowej może udostępniać makra; import nazwanego modułu ich nie udostępnia.

Deklaracja importu musi znajdować się w globalnym zakresie przestrzeni nazw, nie wewnątrz funkcji ani nazwanej przestrzeni nazw. W jednostce modułu importy muszą poprzedzać pozostałe deklaracje w odpowiedniej sekwencji deklaracji. export import module_name; w interfejsie modułu ponownie eksportuje import, udostępniając go odbiorcom tego interfejsu. Cykliczne zależności interfejsów są niedozwolone.

Przykład składa się z dwóch plików: arithmetic.cppm eksportuje square, a main.cpp importuje moduł i sprawdza wynik podczas kompilacji. Nie wypisuje tekstu i powinien zakończyć się kodem 0. Kompilator i system budowania muszą obsługiwać moduły oraz ich zależności; sama flaga C++23 nie potwierdza poprawnego zbudowania ani działania. Podany serwis zawiera rozwijany szkic standardu, a nie zamrożony tekst C++23.

Przykłady

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

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

Źródła