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

CKTIS / C++

import — importar módulos e unidades de cabeçalho

`import` disponibiliza a interface exportada de um módulo nomeado, uma partição do módulo atual ou uma unidade de cabeçalho. Ao contrário de `#include`, não insere o conteúdo como texto; importar um módulo nomeado não disponibiliza macros.

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

Sintaxe

import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;

import arithmetic; importa a interface de um módulo nomeado: os nomes que este exporta ficam disponíveis para a pesquisa de nomes após a declaração de importação. A importação não cria um espaço de nomes nem insere textualmente um ficheiro. O nome de um módulo não é um nome de ficheiro.

import :partition_name; importa uma partição do mesmo módulo e só pode surgir após a respetiva declaração module. import <header>; e import "header"; importam uma unidade de cabeçalho, ou seja, uma unidade de tradução separada formada a partir de um cabeçalho importável. A importação direta de uma unidade de cabeçalho pode disponibilizar macros; a importação de um módulo nomeado não o faz.

Uma declaração de importação tem de estar no âmbito do espaço de nomes global, não dentro de uma função ou de um espaço de nomes nomeado. Numa unidade de módulo, as importações têm de preceder as restantes declarações na sequência de declarações relevante. export import module_name; numa interface de módulo volta a exportar a importação, tornando-a disponível aos utilizadores dessa interface. As dependências cíclicas entre interfaces são proibidas.

O exemplo é composto por dois ficheiros: arithmetic.cppm exporta square, e main.cpp importa o módulo e verifica o resultado em tempo de compilação. Não apresenta qualquer saída e deverá terminar com o estado 0. O compilador e o sistema de compilação têm de suportar módulos e as respetivas dependências; uma opção C++23, por si só, não comprova uma compilação ou execução bem-sucedida. O site indicado contém um rascunho de trabalho em evolução, não o texto definitivo de C++23.

Exemplos

// arithmetic.cppm
export module arithmetic;
export constexpr int square(int x) { return x * x; }

// main.cpp
import arithmetic;
static_assert(square(6) == 36);
int main() {
    return square(6) == 36 ? 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