CKTIS / C++
import — importare moduli e unità di intestazione
`import` rende disponibile l’interfaccia esportata di un modulo con nome, una partizione del modulo corrente o un’unità di intestazione. A differenza di `#include`, non incolla il contenuto come testo; importare un modulo con nome non rende disponibili le macro.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;import arithmetic; importa l’interfaccia di un modulo con nome: i suoi nomi esportati diventano disponibili per la ricerca dei nomi dopo la dichiarazione di importazione. L’importazione non crea uno spazio dei nomi né incolla testualmente un file. Il nome di un modulo non è un nome di file.
import :partition_name; importa una partizione dello stesso modulo e può comparire solo dopo la relativa dichiarazione module. import <header>; e import "header"; importano un’unità di intestazione, cioè un’unità di traduzione separata formata a partire da un’intestazione importabile. L’importazione diretta di un’unità di intestazione può rendere disponibili le macro; l’importazione di un modulo con nome non lo fa.
Una dichiarazione di importazione deve trovarsi nell’ambito dello spazio dei nomi globale, non all’interno di una funzione o di uno spazio dei nomi con nome. In un’unità di modulo, le importazioni devono precedere le altre dichiarazioni nella sequenza di dichiarazioni pertinente. export import module_name; in un’interfaccia di modulo riesporta l’importazione, rendendola disponibile agli utilizzatori di quell’interfaccia. Le dipendenze cicliche tra interfacce sono vietate.
L’esempio è composto da due file: arithmetic.cppm esporta square, mentre main.cpp importa il modulo e verifica il risultato in fase di compilazione. Non stampa nulla e dovrebbe terminare con stato 0. Il compilatore e il sistema di build devono supportare i moduli e le relative dipendenze; un’opzione C++23 da sola non attesta una compilazione o un’esecuzione riuscita. Il sito fornito contiene una bozza di lavoro in evoluzione, non il testo definitivo di C++23.
Esempi
// 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;
}
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.