Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

module — declarações de módulo

`module` especifica que uma unidade de tradução pertence a um módulo com nome ou inicia um fragmento de módulo. Distingue `export module M;`, `module M;` e `import M;`: declaram, respetivamente, uma interface, uma implementação e a utilização de um módulo.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

module é reconhecido como palavra-chave na sintaxe de módulos, ao contrário de int, que é sempre uma palavra-chave. export module M; inicia a unidade de interface primária, enquanto module M; inicia uma unidade de implementação. Um módulo com nome tem exatamente uma unidade de interface primária. Um módulo não é um espaço de nomes: o nome M, por si só, não cria o qualificador M::.

export module M:Part; declara uma partição de interface, e module M:Part; declara uma partição de implementação. As partições só podem ser importadas dentro do mesmo módulo. O código que utiliza a interface escreve import M;, não module M;. As declarações destinadas à pesquisa de nomes pelos importadores são marcadas com export; importar um módulo com nome não disponibiliza as respetivas macros.

module; inicia um fragmento global de módulo antes da declaração do módulo com nome, útil para incluir cabeçalhos tradicionais. module :private; inicia um fragmento privado, cujas declarações não são acessíveis aos importadores. Só é permitido na unidade de interface primária; um módulo com esse fragmento não pode ter outras unidades de módulo.

O exemplo é constituído por dois ficheiros separados. answer exporta a função value, e main.cpp verifica o resultado em tempo de compilação e em tempo de execução. A compilação tem de disponibilizar a interface compilada ao importador; não presuma que basta compilar o texto concatenado. Esta entrada diz respeito a C++23; o sítio indicado contém um projeto de norma em evolução, não uma edição C++23 definitiva. A existência de uma opção do compilador no repositório não atesta o funcionamento num ambiente de produção.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes