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

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.

Fontes