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

CKTIS / C++

Modules et frontières d’interface en C++

Un module nommé regroupe des unités de traduction et expose des déclarations au moyen de `export`. `import` permet aux clients d’utiliser son interface sans inclure un fichier textuellement. La frontière du module sépare l’API de l’implémentation, mais ne constitue ni une frontière de sécurité ni un espace de noms distinct.

Version : 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;

Un module nommé est un ensemble d’unités de traduction partageant le même nom de module. Une seule est l’unité d’interface primaire, dont la déclaration de module est export module M;. Cette déclaration peut être précédée d’un fragment de module global introduit par module;. Une unité d’implémentation qui n’est pas une partition se déclare avec module M;, tandis qu’une partition d’implémentation se déclare avec module M:Part;. export expose les déclarations aux clients, et import M; permet la recherche des noms exportés. Un module ne crée pas lui-même d’espace de noms.

La frontière d’interface régit la disponibilité des noms, pas le secret du code. Les noms non exportés ne deviennent pas une API client ordinaire du seul fait d’un import, mais les déclarations nécessaires à l’interprétation des entités exportées peuvent tout de même être accessibles au compilateur. Dans l’exemple, le client appelle get_answer(), tandis que helper() reste dans l’espace de noms sans nom de l’unité d’implémentation.

Les partitions, comme M:Part, divisent un module en unités qui ne peuvent être importées qu’au sein du même module avec import :Part;. Les partitions d’interface doivent être réexportées directement ou indirectement par l’interface primaire. export import N; réexporte une dépendance. L’import d’un module nommé n’expose pas les macros ; import "header.h"; désigne une unité d’en-tête distincte, qui peut exposer des macros.

L’exemple comprend trois fichiers séparés, et non un seul fichier source. Construisez l’interface avant les unités qui en dépendent et liez tous les fichiers objet. Les options de compilation des modules doivent être adaptées au compilateur ; une option C++23 ne suffit pas à attester le fonctionnement en production. La source citée est un document de travail en évolution, et non une publication C++23 figée.

Exemples

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

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