CKTIS / C++
export — expor uma interface de módulo
A palavra-chave `export` marca uma unidade de interface de módulo, disponibiliza declarações aos importadores ou volta a exportar uma importação. Escrever apenas `export module M;` não exporta automaticamente todas as declarações seguintes.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
export module M;
export declaration
export { declarations }
export import M;export module M; marca uma unidade de interface do módulo com nome M. Em contrapartida, module M; inicia uma unidade de implementação. Marcar a interface, por si só, não exporta todas as declarações que contém.
export int f(); exporta uma declaração de função, enquanto export { ... } agrupa declarações exportadas sem criar um novo âmbito. Os respetivos nomes podem ser encontrados por pesquisa de nomes numa unidade de tradução que importe o módulo. As declarações de exportação têm de estar no âmbito de espaço de nomes, dentro de uma unidade de interface de módulo; não podem surgir num espaço de nomes sem nome nem num fragmento privado de módulo. export static int x; é inválido porque o nome tem ligação interna.
export import M; volta a exportar uma importação: disponibiliza também a interface exportada de M aos importadores do módulo atual. Um import M; simples não efetua essa reexportação. Na sequência de declarações da unidade de módulo, as importações, incluindo as reexportadas, têm de preceder todas as restantes declarações dessa sequência. Se a unidade tiver um fragmento privado de módulo, a regra aplica-se aí separadamente: as importações têm de preceder todas as restantes declarações do fragmento. Assim, uma importação simples no início do fragmento privado pode surgir depois de declarações da sequência anterior.
O exemplo requer dois ficheiros separados. answer_value é exportada, pelo que main.cpp pode chamar a função após import answer;. A fonte em eel.is é um rascunho em evolução, não uma edição C++23 definitiva; o suporte de módulos tem de ser verificado localmente.
Exemplos
// answer.cppm
export module answer;
export constexpr int answer_value() {
return 42;
}
// main.cpp
#include <cstdio>
import answer;
int main() {
std::printf("%d\n", answer_value());
}
Resultado
42
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.