CKTIS / C++
Moduli in meje vmesnika v C++
Poimenovani modul združuje prevodne enote in z `export` izpostavi deklaracije. `import` omogoča odjemalcem uporabo vmesnika brez besedilnega vključevanja datoteke. Meja modula ločuje API od implementacije, vendar ni varnostna meja ali samostojen imenski prostor.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Poimenovani modul je zbirka prevodnih enot z enakim imenom modula. Natanko ena je primarna vmesniška enota z deklaracijo modula export module M;. Pred to deklaracijo je lahko globalni fragment modula, ki ga uvede zapis module;. Implementacijsko enoto, ki ni particija, deklariramo z module M;, implementacijsko particijo pa z module M:Part;. export izpostavi deklaracije odjemalcem, import M; pa omogoča iskanje izvoženih imen. Modul sam ne ustvari imenskega prostora.
Meja vmesnika določa dostopnost imen, ne tajnosti kode. Neizvožena imena zgolj zaradi uvoza ne postanejo običajen API za odjemalca, vendar so lahko deklaracije, potrebne za razlago izvoženih entitet, še vedno dosegljive prevajalniku. V primeru odjemalec pokliče get_answer(), medtem ko helper() ostane v neimenovanem imenskem prostoru implementacijske enote.
Particije, kot je M:Part, razdelijo modul na enote, ki jih je mogoče z import :Part; uvoziti samo znotraj istega modula. Primarni vmesnik mora vmesniške particije neposredno ali posredno ponovno izvoziti. export import N; ponovno izvozi odvisnost. Uvoz poimenovanega modula ne izpostavi makrov; import "header.h"; označuje ločeno glavično enoto, ki lahko izpostavi makre.
Primer je sestavljen iz treh ločenih datotek, ne iz ene izvorne datoteke. Vmesnik zgradite pred odvisnimi enotami in povežite vse objektne datoteke. Možnosti za gradnjo modulov je treba izbrati glede na prevajalnik; zastavica C++23 sama po sebi ne potrjuje delovanja v produkciji. Navedeni vir je delovni osnutek, ki se še razvija, ne dokončna izdaja C++23.
Primeri
// 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;
}
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.