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.