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

CKTIS / C++

export — zpřístupnění rozhraní modulu

Klíčové slovo `export` označuje jednotku rozhraní modulu, zpřístupňuje deklarace importujícím jednotkám nebo znovu exportuje import. Samotné `export module M;` automaticky neexportuje všechny následující deklarace.

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

Syntaxe

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

export module M; označuje jednotku rozhraní pojmenovaného modulu M. Naproti tomu module M; zahajuje jednotku implementace. Samotné označení rozhraní neexportuje všechny deklarace, které obsahuje.

export int f(); exportuje deklaraci funkce, zatímco export { ... } seskupuje exportované deklarace, aniž by vytvářelo nový rozsah. Jejich názvy lze nalézt pomocí vyhledávání názvů v překladové jednotce, která modul importuje. Exportované deklarace musí být v rozsahu jmenného prostoru uvnitř jednotky rozhraní modulu; nesmějí se nacházet v nepojmenovaném jmenném prostoru ani v soukromém fragmentu modulu. export static int x; je neplatné, protože název má interní vazbu.

export import M; znovu exportuje import: exportované rozhraní M zpřístupňuje také importujícím jednotkám aktuálního modulu. Běžné import M; takový opětovný export nezajišťuje. V posloupnosti deklarací jednotky modulu musí importy, včetně znovu exportovaných, předcházet všem ostatním deklaracím v téže posloupnosti. Pokud jednotka obsahuje soukromý fragment modulu, platí v něm pravidlo samostatně: importy musí předcházet všem ostatním deklaracím v tomto fragmentu. Běžný import na začátku soukromého fragmentu tak může následovat po deklaracích z předchozí posloupnosti.

Příklad vyžaduje dva samostatné soubory. answer_value je exportována, takže ji main.cpp může zavolat po import answer;. Zdroj na eel.is je průběžně upravovaný pracovní návrh, nikoli neměnné vydání C++23; podporu modulů je třeba ověřit lokálně.

Příklady

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

Výsledek

42

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