CKTIS / C++
Moduly a hranice rozhraní v C++
Pojmenovaný modul sdružuje překladové jednotky a zpřístupňuje deklarace pomocí `export`. `import` umožňuje klientům používat jeho rozhraní bez textového vložení souboru. Hranice modulu odděluje API od implementace, ale není bezpečnostní hranicí ani samostatným jmenným prostorem.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Pojmenovaný modul je kolekce překladových jednotek se stejným názvem modulu. Přesně jedna z nich je primární jednotka rozhraní s deklarací modulu export module M;. Této deklaraci může předcházet globální fragment modulu uvedený zápisem module;. Implementační jednotka, která není oddílem, se deklaruje pomocí module M;, zatímco implementační oddíl pomocí module M:Part;. export zpřístupňuje deklarace klientům a import M; umožňuje vyhledávání exportovaných názvů. Modul sám o sobě jmenný prostor nevytváří.
Hranice rozhraní řídí dostupnost názvů, nikoli utajení kódu. Neexportované názvy se pouhým importem nestávají běžným klientským API, ale deklarace potřebné k interpretaci exportovaných entit mohou být pro kompilátor stále dosažitelné. V příkladu klient volá get_answer(), zatímco helper() zůstává v nepojmenovaném jmenném prostoru implementační jednotky.
Oddíly, například M:Part, rozdělují modul na jednotky, které lze pomocí import :Part; importovat pouze uvnitř téhož modulu. Oddíly rozhraní musí primární rozhraní přímo či nepřímo znovu exportovat. export import N; znovu exportuje závislost. Import pojmenovaného modulu nezpřístupňuje makra; import "header.h"; označuje samostatnou jednotku hlavičky, která makra zpřístupňovat může.
Příklad se skládá ze tří samostatných souborů, nikoli z jednoho zdrojového souboru. Rozhraní sestavte před závislými jednotkami a propojte všechny objektové soubory. Možnosti sestavení modulů je nutné zvolit podle kompilátoru; samotný příznak C++23 nepotvrzuje fungování v produkčním prostředí. Uvedený zdroj je průběžně vyvíjený pracovní návrh, nikoli zmrazené vydání C++23.
Pří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ýsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.