CKTIS / C++
import — modules en header-units importeren
`import` maakt de geëxporteerde interface van een benoemde module, een partitie van de huidige module of een header-unit beschikbaar. In tegenstelling tot `#include` voegt het inhoud niet tekstueel in; bij het importeren van een benoemde module komen macro’s niet beschikbaar.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;import arithmetic; importeert de interface van een benoemde module: de geëxporteerde namen zijn na de importdeclaratie beschikbaar voor naamopzoeking. Importeren maakt geen naamruimte aan en voegt geen bestand tekstueel in. Een modulenaam is geen bestandsnaam.
import :partition_name; importeert een partitie van dezelfde module en mag pas na de bijbehorende module-declaratie staan. import <header>; en import "header"; importeren een header-unit: een afzonderlijke vertaaleenheid die uit een importeerbare header is gevormd. Een header-unit rechtstreeks importeren kan macro’s beschikbaar maken; een benoemde module importeren doet dat niet.
Een importdeclaratie moet in de globale naamruimtescope staan, niet binnen een functie of een benoemde naamruimte. In een module-eenheid moeten imports in de relevante declaratiereeks vóór de overige declaraties staan. export import module_name; exporteert de import in een module-interface opnieuw, zodat deze beschikbaar is voor gebruikers van die interface. Cyclische afhankelijkheden tussen interfaces zijn verboden.
Het voorbeeld bestaat uit twee bestanden: arithmetic.cppm exporteert square, en main.cpp importeert de module en controleert het resultaat tijdens het compileren. Het schrijft niets naar uitvoer en hoort met status 0 af te sluiten. De compiler en het build-systeem moeten modules en hun afhankelijkheden ondersteunen; alleen een C++23-vlag bewijst niet dat de build of uitvoering is geslaagd. De opgegeven site bevat een evoluerend werkdocument, niet de definitieve C++23-tekst.
Voorbeelden
// 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;
}
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.