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

CKTIS / C++

export — exposer une interface de module

Le mot-clé `export` marque une unité d’interface de module, rend des déclarations accessibles aux importateurs ou réexporte un import. À lui seul, `export module M;` n’exporte pas automatiquement toutes les déclarations suivantes.

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

Syntaxe

export module M;
export declaration
export { declarations }
export import M;

export module M; marque une unité d’interface du module nommé M. En revanche, module M; commence une unité d’implémentation. Le simple fait de marquer l’interface n’exporte pas toutes les déclarations qu’elle contient.

export int f(); exporte une déclaration de fonction, tandis que export { ... } regroupe des déclarations exportées sans créer de nouvelle portée. Leurs noms peuvent être trouvés par recherche de noms dans une unité de traduction qui importe le module. Les déclarations d’export doivent se trouver dans une portée d’espace de noms au sein d’une unité d’interface de module ; elles ne peuvent pas apparaître dans un espace de noms sans nom ni dans un fragment privé de module. export static int x; est invalide, car le nom possède une liaison interne.

export import M; réexporte un import : il rend aussi l’interface exportée de M accessible aux importateurs du module courant. Un simple import M; ne réalise pas cette réexportation. Dans la séquence de déclarations de l’unité de module, les imports, y compris ceux qui sont réexportés, doivent précéder toutes les autres déclarations de cette séquence. Si l’unité comporte un fragment privé de module, la règle s’y applique séparément : les imports doivent précéder toutes les autres déclarations du fragment. Un import simple placé au début du fragment privé peut donc apparaître après des déclarations de la séquence précédente.

L’exemple nécessite deux fichiers distincts. answer_value est exportée, donc main.cpp peut appeler cette fonction après import answer;. La source sur eel.is est un brouillon en évolution, et non une édition C++23 figée ; la prise en charge des modules doit être vérifiée localement.

Exemples

// answer.cppm
export module answer;

export constexpr int answer_value() {
    return 42;
}

// main.cpp
#include <cstdio>
import answer;

int main() {
    std::printf("%d\n", answer_value());
}

Résultat

42

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