Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

module — déclarations de module

`module` indique qu’une unité de traduction appartient à un module nommé ou commence un fragment de module. Distinguez `export module M;`, `module M;` et `import M;` : ils déclarent respectivement une interface, une implémentation et l’utilisation d’un module.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

export module M;
module M;
export module M:Part;
module M:Part;
module;
module :private;

module est reconnu comme un mot-clé dans la syntaxe des modules, contrairement à int, qui est toujours un mot-clé. export module M; commence l’unité d’interface primaire, tandis que module M; commence une unité d’implémentation. Un module nommé possède exactement une unité d’interface primaire. Un module n’est pas un espace de noms : le nom M seul ne crée pas de qualificateur M::.

export module M:Part; déclare une partition d’interface, et module M:Part; une partition d’implémentation. Les partitions ne peuvent être importées qu’au sein du même module. Le code qui utilise l’interface écrit import M;, et non module M;. Les déclarations destinées à être trouvées par les importateurs sont marquées export ; l’importation d’un module nommé ne rend pas ses macros disponibles.

module; commence un fragment de module global avant la déclaration du module nommé ; il est utile pour inclure des en-têtes traditionnels. module :private; commence un fragment privé, dont les déclarations ne sont pas accessibles aux importateurs. Il n’est autorisé que dans l’unité d’interface primaire ; un module contenant un tel fragment ne peut pas avoir d’autres unités de module.

L’exemple se compose de deux fichiers distincts. answer exporte la fonction value, et main.cpp vérifie le résultat à la compilation et à l’exécution. La construction doit rendre l’interface compilée disponible à l’importateur ; ne supposez pas qu’il suffit de compiler le texte concaténé. Cette entrée porte sur C++23 ; le site référencé contient un projet de norme en évolution, et non une édition C++23 figée. La présence d’une option de compilateur dans le dépôt ne garantit pas le fonctionnement dans un environnement de production.

Exemples

// 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;
}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources