CKTIS / C++
Moduly a hranice rozhrania v C++
Pomenovaný modul združuje prekladové jednotky a sprístupňuje deklarácie pomocou `export`. `import` umožňuje klientom používať jeho rozhranie bez textového vloženia súboru. Hranica modulu oddeľuje API od implementácie, ale nie je bezpečnostnou hranicou ani samostatným menným priestorom.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Pomenovaný modul je kolekcia prekladových jednotiek s rovnakým názvom modulu. Presne jedna z nich je primárna jednotka rozhrania s deklaráciou modulu export module M;. Tejto deklarácii môže predchádzať globálny fragment modulu uvedený zápisom module;. Implementačná jednotka, ktorá nie je partíciou, sa deklaruje pomocou module M;, zatiaľ čo implementačná partícia pomocou module M:Part;. export sprístupňuje deklarácie klientom a import M; umožňuje vyhľadávanie exportovaných názvov. Modul sám osebe nevytvára menný priestor.
Hranica rozhrania riadi dostupnosť názvov, nie utajenie kódu. Neexportované názvy sa samotným importom nestávajú bežným klientskym API, no deklarácie potrebné na interpretáciu exportovaných entít môžu byť pre kompilátor stále dosiahnuteľné. V príklade klient volá get_answer(), zatiaľ čo helper() zostáva v nepomenovanom mennom priestore implementačnej jednotky.
Partície, ako napríklad M:Part, rozdeľujú modul na jednotky, ktoré možno pomocou import :Part; importovať iba v rámci toho istého modulu. Partície rozhrania musí primárne rozhranie priamo alebo nepriamo znovu exportovať. export import N; znovu exportuje závislosť. Import pomenovaného modulu nesprístupňuje makrá; import "header.h"; označuje samostatnú hlavičkovú jednotku, ktorá makrá sprístupňovať môže.
Príklad pozostáva z troch samostatných súborov, nie z jedného zdrojového súboru. Rozhranie zostavte pred závislými jednotkami a prepojte všetky objektové súbory. Možnosti zostavovania modulov treba zvoliť podľa kompilátora; samotný príznak C++23 nepotvrdzuje fungovanie v produkčnom prostredí. Uvedený zdroj je priebežne vyvíjaný pracovný návrh, nie zmrazené vydanie C++23.
Príklady
// 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;
}
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.