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

CKTIS / C++

Módulos y límites de interfaz en C++

Un módulo con nombre agrupa unidades de traducción y expone declaraciones mediante `export`. `import` permite a los clientes usar su interfaz sin incluir textualmente un archivo. El límite del módulo separa la API de la implementación, pero no es una frontera de seguridad ni un espacio de nombres independiente.

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

Sintaxis

export module M;
export int answer();

// Separate implementation unit:
module M;
int answer() { return 42; }

// Separate importing translation unit:
import M;

Un módulo con nombre es un conjunto de unidades de traducción que comparten el mismo nombre de módulo. Exactamente una es la unidad de interfaz primaria, cuya declaración de módulo es export module M;. Esta declaración puede ir precedida de un fragmento de módulo global introducido por module;. Una unidad de implementación que no es una partición se declara con module M;, mientras que una partición de implementación se declara con module M:Part;. export expone declaraciones a los clientes, y import M; permite buscar los nombres exportados. Un módulo no crea por sí mismo un espacio de nombres.

El límite de interfaz controla la disponibilidad de nombres, no el secreto del código. Los nombres no exportados no se convierten en una API ordinaria para el cliente por el mero hecho de importar el módulo, aunque las declaraciones necesarias para interpretar las entidades exportadas aún pueden ser accesibles para el compilador. En el ejemplo, el cliente llama a get_answer(), mientras que helper() permanece en el espacio de nombres sin nombre de la unidad de implementación.

Las particiones, como M:Part, dividen un módulo en unidades que solo pueden importarse dentro del mismo módulo mediante import :Part;. La interfaz primaria debe reexportar las particiones de interfaz, directa o indirectamente. export import N; reexporta una dependencia. Importar un módulo con nombre no expone macros; import "header.h"; designa una unidad de cabecera distinta, que puede exponer macros.

El ejemplo consta de tres archivos separados, no de un único archivo fuente. Compila la interfaz antes que las unidades que dependen de ella y enlaza todos los archivos objeto. Las opciones de compilación de módulos deben elegirse para cada compilador; una opción C++23 por sí sola no acredita el funcionamiento en producción. La fuente citada es un borrador de trabajo en evolución, no una publicación definitiva de C++23.

Ejemplos

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

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