CKTIS / C++
Módulos e limites de interface em C++
Um módulo com nome agrupa unidades de tradução e expõe declarações através de `export`. `import` permite aos clientes usar a sua interface sem incluir textualmente um ficheiro. O limite do módulo separa a API da implementação, mas não é uma fronteira de segurança nem um espaço de nomes distinto.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Um módulo com nome é um conjunto de unidades de tradução que partilham o mesmo nome de módulo. Exatamente uma é a unidade de interface primária, cuja declaração de módulo é export module M;. Esta declaração pode ser precedida por um fragmento de módulo global introduzido por module;. Uma unidade de implementação que não seja uma partição é declarada com module M;, enquanto uma partição de implementação é declarada com module M:Part;. export expõe declarações aos clientes e import M; permite procurar os nomes exportados. Um módulo não cria, por si só, um espaço de nomes.
O limite da interface controla a disponibilidade dos nomes, não o sigilo do código. Os nomes não exportados não se tornam uma API comum para o cliente apenas por importar o módulo, mas as declarações necessárias para interpretar as entidades exportadas podem continuar acessíveis ao compilador. No exemplo, o cliente chama get_answer(), enquanto helper() permanece no espaço de nomes sem nome da unidade de implementação.
As partições, como M:Part, dividem um módulo em unidades que só podem ser importadas dentro do mesmo módulo através de import :Part;. As partições de interface têm de ser reexportadas direta ou indiretamente pela interface primária. export import N; reexporta uma dependência. Importar um módulo com nome não expõe macros; import "header.h"; designa uma unidade de cabeçalho distinta, que pode expor macros.
O exemplo é constituído por três ficheiros separados, não por um único ficheiro de código-fonte. Compile a interface antes das unidades que dela dependem e ligue todos os ficheiros objeto. As opções de compilação de módulos têm de ser escolhidas para o compilador; uma opção C++23, por si só, não comprova o funcionamento em produção. A fonte citada é um projeto de trabalho em evolução, não uma publicação C++23 definitiva.
Exemplos
// 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;
}
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.