Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

module — declaraciones de módulo

`module` indica que una unidad de traducción pertenece a un módulo con nombre o inicia un fragmento de módulo. Distingue `export module M;`, `module M;` e `import M;`: declaran, respectivamente, una interfaz, una implementación y el uso de un módulo.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

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

module se reconoce como palabra clave en la sintaxis de módulos, a diferencia de int, que siempre es una palabra clave. export module M; inicia la unidad de interfaz primaria, mientras que module M; inicia una unidad de implementación. Un módulo con nombre tiene exactamente una unidad de interfaz primaria. Un módulo no es un espacio de nombres: el nombre M por sí solo no crea el calificador M::.

export module M:Part; declara una partición de interfaz, y module M:Part; declara una partición de implementación. Las particiones solo se pueden importar dentro del mismo módulo. El código que usa la interfaz escribe import M;, no module M;. Las declaraciones que deben estar disponibles para la búsqueda de nombres de los importadores se marcan con export; importar un módulo con nombre no hace que sus macros estén disponibles.

module; inicia un fragmento global de módulo antes de la declaración del módulo con nombre, útil para incluir encabezados tradicionales. module :private; inicia un fragmento privado cuyas declaraciones no son accesibles para los importadores. Solo se permite en la unidad de interfaz primaria; un módulo que contenga ese fragmento no puede tener otras unidades de módulo.

El ejemplo consta de dos archivos separados. answer exporta la función value, y main.cpp comprueba el resultado en tiempo de compilación y en tiempo de ejecución. La compilación debe poner la interfaz compilada a disposición del importador; no des por hecho que basta con compilar el texto concatenado. Esta entrada trata sobre C++23; el sitio indicado contiene un borrador en evolución, no una edición definitiva de C++23. Que el repositorio incluya una opción del compilador no demuestra que funcione en un entorno de producción.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes