Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

export — esporre un’interfaccia di modulo

La parola chiave `export` contrassegna un’unità di interfaccia di modulo, rende le dichiarazioni disponibili agli importatori oppure riesporta un’importazione. Scrivere soltanto `export module M;` non esporta automaticamente tutte le dichiarazioni successive.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

export module M;
export declaration
export { declarations }
export import M;

export module M; contrassegna un’unità di interfaccia del modulo con nome M. Al contrario, module M; avvia un’unità di implementazione. Il solo fatto di contrassegnare l’interfaccia non esporta tutte le dichiarazioni che contiene.

export int f(); esporta una dichiarazione di funzione, mentre export { ... } raggruppa dichiarazioni esportate senza creare un nuovo ambito. I loro nomi possono essere trovati tramite la ricerca dei nomi in un’unità di traduzione che importa il modulo. Le dichiarazioni di esportazione devono trovarsi nell’ambito dello spazio dei nomi, all’interno di un’unità di interfaccia di modulo; non possono comparire in uno spazio dei nomi senza nome né in un frammento privato del modulo. export static int x; non è valido perché il nome ha collegamento interno.

export import M; riesporta un’importazione: rende l’interfaccia esportata di M disponibile anche agli importatori del modulo corrente. Un normale import M; non effettua questa riesportazione. Nella sequenza di dichiarazioni dell’unità di modulo, le importazioni, comprese quelle riesportate, devono precedere tutte le altre dichiarazioni della stessa sequenza. Se l’unità contiene un frammento privato del modulo, la regola si applica separatamente al suo interno: le importazioni devono precedere tutte le altre dichiarazioni del frammento. Una semplice importazione all’inizio del frammento privato può quindi comparire dopo dichiarazioni della sequenza precedente.

L’esempio richiede due file separati. answer_value è esportata, quindi main.cpp può chiamare la funzione dopo import answer;. La fonte su eel.is è una bozza in evoluzione, non un’edizione C++23 definitiva; il supporto dei moduli deve essere verificato localmente.

Esempi

// 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());
}

Risultato

42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti