Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Moduły i granice interfejsu w C++

Moduł nazwany grupuje jednostki translacji i udostępnia deklaracje przez export. import pozwala korzystać z jego interfejsu bez tekstowego dołączania pliku. Granica modułu oddziela API od implementacji, lecz nie jest granicą bezpieczeństwa ani osobną przestrzenią nazw.

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

Składnia

export module M;
export int answer();

// Separate implementation unit:
module M;
int answer() { return 42; }

// Separate importing translation unit:
import M;

Moduł nazwany to zbiór jednostek translacji o tej samej nazwie modułu. Dokładnie jedna jest główną jednostką interfejsu i zawiera deklarację export module M;. Deklarację tę może poprzedzać globalny fragment modułu wprowadzany przez module;. Jednostka implementacji niebędąca partycją ma deklarację module M;, a partycja implementacji — module M:Part;. export udostępnia deklaracje odbiorcom, a import M; umożliwia wyszukiwanie wyeksportowanych nazw. Sam moduł nie tworzy przestrzeni nazw.

Granica interfejsu określa dostępność nazw, nie poufność kodu. Nazwy niewyeksportowane nie stają się przez sam import zwykłym API odbiorcy, ale deklaracje potrzebne do interpretacji eksportowanych elementów mogą nadal być osiągalne dla kompilatora. W przykładzie odbiorca wywołuje get_answer(), natomiast helper() pozostaje w anonimowej przestrzeni nazw jednostki implementacji.

Partycje, np. M:Part, dzielą moduł na jednostki importowane wyłącznie wewnątrz tego samego modułu przez import :Part;. Partycje interfejsu muszą być bezpośrednio lub pośrednio reeksportowane przez główny interfejs. export import N; reeksportuje zależność. Import modułu nazwanego nie udostępnia makr; import "header.h"; oznacza odrębną jednostkę nagłówkową, która może udostępniać makra.

Przykład obejmuje trzy osobne pliki, nie jeden plik źródłowy. Zbuduj interfejs przed jednostkami zależnymi i połącz wszystkie pliki obiektowe. Opcje budowania modułów trzeba dobrać do kompilatora; sama flaga C++23 nie potwierdza działania produkcyjnego. Podane źródło jest rozwijanym szkicem, nie zamrożoną publikacją C++23.

Przykłady

// answer.cppm
export module answer;
export int get_answer();

// answer_impl.cpp
module answer;
namespace {
    int helper() { return 42; }
}
int get_answer() { return helper(); }

// main.cpp
import answer;

int main() {
    return get_answer() == 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