Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

module — deklarace modulů

`module` určuje, že překladová jednotka patří do pojmenovaného modulu, nebo zahajuje fragment modulu. Rozlišujte `export module M;`, `module M;` a `import M;`: deklarují rozhraní, implementaci a použití modulu.

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

Syntaxe

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

module se rozpoznává jako klíčové slovo v syntaxi modulů, na rozdíl od int, který je klíčovým slovem vždy. export module M; zahajuje primární jednotku rozhraní, zatímco module M; zahajuje jednotku implementace. Pojmenovaný modul má právě jednu primární jednotku rozhraní. Modul není jmenný prostor: samotný název M nevytváří kvalifikátor M::.

export module M:Part; deklaruje oddíl rozhraní a module M:Part; oddíl implementace. Oddíly lze importovat pouze uvnitř stejného modulu. Kód používající rozhraní zapisuje import M;, nikoli module M;. Deklarace určené k vyhledávání jmen importujícími se označují pomocí export; import pojmenovaného modulu nezpřístupní jeho makra.

module; zahajuje globální fragment modulu před deklarací pojmenovaného modulu; hodí se k zahrnutí tradičních hlaviček. module :private; zahajuje soukromý fragment, jehož deklarace nejsou importujícím přístupné. Je povolen pouze v primární jednotce rozhraní; modul s takovým fragmentem nesmí mít jiné jednotky modulu.

Příklad tvoří dva samostatné soubory. answer exportuje funkci value a main.cpp kontroluje výsledek při překladu i za běhu. Sestavení musí zpřístupnit zkompilované rozhraní importující jednotce; nepředpokládejte, že stačí přeložit spojený text. Tento záznam se týká C++23; uvedený web obsahuje průběžně se vyvíjející pracovní návrh, nikoli zmrazené vydání C++23. Příznak překladače v repozitáři nedokládá funkčnost v produkčním prostředí.

Příklady

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje