KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

module — moduledeclaraties

`module` geeft aan dat een translation unit bij een benoemde module hoort of begint een modulefragment. Maak onderscheid tussen `export module M;`, `module M;` en `import M;`: ze declareren respectievelijk een interface, een implementatie en het gebruik van een module.

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

Syntax

export module M;
module M;
export module M:Part;
module M:Part;
module;
module :private;

module wordt herkend als sleutelwoord in de modulesyntaxis, anders dan int, dat altijd een sleutelwoord is. export module M; begint de primaire interface-eenheid, terwijl module M; een implementatie-eenheid begint. Een benoemde module heeft precies één primaire interface-eenheid. Een module is geen namespace: de naam M op zichzelf maakt geen kwalificatie M:: aan.

export module M:Part; declareert een interfacepartitie, en module M:Part; een implementatiepartitie. Partities kunnen alleen binnen dezelfde module worden geïmporteerd. Code die de interface gebruikt, schrijft import M;, niet module M;. Declaraties die importeurs bij naamopzoeking moeten kunnen vinden, krijgen het kenmerk export; door een benoemde module te importeren worden de macro’s ervan niet beschikbaar.

module; begint vóór de declaratie van de benoemde module een globaal modulefragment, handig voor het opnemen van traditionele headers. module :private; begint een privéfragment waarvan de declaraties niet bereikbaar zijn voor importeurs. Dit is alleen toegestaan in de primaire interface-eenheid; een module met zo’n fragment mag geen andere module-eenheden hebben.

Het voorbeeld bestaat uit twee afzonderlijke bestanden. answer exporteert de functie value, en main.cpp controleert het resultaat tijdens het compileren en uitvoeren. De build moet de gecompileerde interface beschikbaar maken voor de importeur; ga er niet van uit dat het compileren van de samengevoegde tekst volstaat. Dit item is gericht op C++23; de genoemde site bevat een werkdocument dat nog verandert, geen vastgestelde C++23-editie. Een compileroptie in de repository bewijst niet dat dit in een productieomgeving werkt.

Voorbeelden

// answer.cppm
export module answer;
export constexpr int value() { return 42; }

// main.cpp
import answer;
static_assert(value() == 42);

int main() {
    return value() == 42 ? 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.

Bronnen