CKTIS / C++
Moduli e confini dell’interfaccia in C++
Un modulo con nome raggruppa unità di traduzione ed espone dichiarazioni tramite `export`. `import` consente ai client di usare la sua interfaccia senza includere testualmente un file. Il confine del modulo separa l’API dall’implementazione, ma non è né un confine di sicurezza né uno spazio dei nomi distinto.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Un modulo con nome è un insieme di unità di traduzione che condividono lo stesso nome di modulo. Esattamente una è l’unità di interfaccia primaria, la cui dichiarazione di modulo è export module M;. Questa dichiarazione può essere preceduta da un frammento di modulo globale introdotto da module;. Un’unità di implementazione che non è una partizione si dichiara con module M;, mentre una partizione di implementazione si dichiara con module M:Part;. export espone dichiarazioni ai client e import M; consente di cercare i nomi esportati. Un modulo non crea di per sé uno spazio dei nomi.
Il confine dell’interfaccia regola la disponibilità dei nomi, non la segretezza del codice. I nomi non esportati non diventano una normale API per il client solo perché il modulo viene importato, ma le dichiarazioni necessarie per interpretare le entità esportate possono comunque essere raggiungibili dal compilatore. Nell’esempio, il client chiama get_answer(), mentre helper() resta nello spazio dei nomi senza nome dell’unità di implementazione.
Le partizioni, come M:Part, suddividono un modulo in unità che possono essere importate solo all’interno dello stesso modulo con import :Part;. Le partizioni di interfaccia devono essere riesportate, direttamente o indirettamente, dall’interfaccia primaria. export import N; riesporta una dipendenza. L’importazione di un modulo con nome non espone macro; import "header.h"; indica un’unità di intestazione distinta, che può esporre macro.
L’esempio è composto da tre file separati, non da un unico file sorgente. Compila l’interfaccia prima delle unità che dipendono da essa e collega tutti i file oggetto. Le opzioni di compilazione dei moduli devono essere scelte in base al compilatore; un flag C++23 da solo non attesta il funzionamento in produzione. La fonte citata è una bozza di lavoro in evoluzione, non una pubblicazione C++23 definitiva.
Esempi
// 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;
}
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.