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

CKTIS / C++

import — importer des modules et des unités d’en-tête

`import` rend disponible l’interface exportée d’un module nommé, une partition du module courant ou une unité d’en-tête. Contrairement à `#include`, il ne colle pas textuellement le contenu ; importer un module nommé ne rend pas les macros disponibles.

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

Syntaxe

import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;

import arithmetic; importe l’interface d’un module nommé : ses noms exportés sont disponibles pour la recherche de noms après la déclaration d’importation. L’importation ne crée pas d’espace de noms et ne colle pas textuellement un fichier. Un nom de module n’est pas un nom de fichier.

import :partition_name; importe une partition du même module et ne peut apparaître qu’après sa déclaration module. import <header>; et import "header"; importent une unité d’en-tête, c’est-à-dire une unité de traduction distincte formée à partir d’un en-tête importable. L’importation directe d’une unité d’en-tête peut rendre des macros disponibles ; importer un module nommé ne le fait pas.

Une déclaration d’importation doit se trouver dans l’espace de noms global, et non dans une fonction ou un espace de noms nommé. Dans une unité de module, les importations doivent précéder les autres déclarations dans la séquence de déclarations concernée. export import module_name;, dans une interface de module, réexporte l’importation et la rend disponible aux utilisateurs de cette interface. Les dépendances cycliques entre interfaces sont interdites.

L’exemple se compose de deux fichiers : arithmetic.cppm exporte square, et main.cpp importe le module et vérifie le résultat à la compilation. Il n’affiche rien et devrait se terminer avec le code 0. Le compilateur et le système de compilation doivent prendre en charge les modules et leurs dépendances ; un simple indicateur C++23 ne garantit ni une compilation ni une exécution réussie. Le site fourni contient un projet de travail en évolution, et non le texte C++23 définitif.

Exemples

// arithmetic.cppm
export module arithmetic;
export constexpr int square(int x) { return x * x; }

// main.cpp
import arithmetic;
static_assert(square(6) == 36);
int main() {
    return square(6) == 36 ? 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