CKTIS / C++
module — dichiarazioni di modulo
`module` specifica che un’unità di traduzione appartiene a un modulo con nome oppure avvia un frammento di modulo. Distingui `export module M;`, `module M;` e `import M;`: dichiarano rispettivamente un’interfaccia, un’implementazione e l’uso di un modulo.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
export module M;
module M;
export module M:Part;
module M:Part;
module;
module :private;module viene riconosciuto come parola chiave nella sintassi dei moduli, a differenza di int, che è sempre una parola chiave. export module M; avvia l’unità di interfaccia primaria, mentre module M; avvia un’unità di implementazione. Un modulo con nome ha esattamente un’unità di interfaccia primaria. Un modulo non è uno spazio dei nomi: il solo nome M non crea il qualificatore M::.
export module M:Part; dichiara una partizione di interfaccia, mentre module M:Part; dichiara una partizione di implementazione. Le partizioni possono essere importate solo all’interno dello stesso modulo. Il codice che usa l’interfaccia scrive import M;, non module M;. Le dichiarazioni destinate alla ricerca dei nomi da parte degli importatori sono contrassegnate con export; importare un modulo con nome non rende disponibili le sue macro.
module; avvia un frammento globale del modulo prima della dichiarazione del modulo con nome, utile per includere gli header tradizionali. module :private; avvia un frammento privato, le cui dichiarazioni non sono raggiungibili dagli importatori. È consentito solo nell’unità di interfaccia primaria; un modulo che contiene un frammento di questo tipo non può avere altre unità di modulo.
L’esempio è composto da due file separati. answer esporta la funzione value e main.cpp verifica il risultato in fase di compilazione e durante l’esecuzione. La compilazione deve rendere l’interfaccia compilata disponibile all’importatore; non dare per scontato che basti compilare il testo concatenato. Questa voce riguarda C++23; il sito citato contiene una bozza in evoluzione, non un’edizione C++23 definitiva. La presenza di un’opzione del compilatore nel repository non attesta il funzionamento in un ambiente di produzione.
Esempi
// answer.cppm
export module answer;
export constexpr int value() { return 42; }
// main.cpp
import answer;
static_assert(value() == 42);
int main() {
return value() == 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.