KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

export — een module-interface beschikbaar maken

Het sleutelwoord `export` markeert een module-interface-eenheid, maakt declaraties beschikbaar voor importeurs of exporteert een import opnieuw. Alleen `export module M;` schrijven exporteert niet automatisch alle volgende declaraties.

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

Syntax

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

export module M; markeert een interface-eenheid van de benoemde module M. module M; begint daarentegen een implementatie-eenheid. Alleen de interface markeren exporteert niet alle declaraties die erin staan.

export int f(); exporteert een functiedeclaratie, terwijl export { ... } geëxporteerde declaraties groepeert zonder een nieuwe scope te maken. Hun namen kunnen worden gevonden via naamopzoeking in een compilatie-eenheid die de module importeert. Exportdeclaraties moeten zich op namespace-scope binnen een module-interface-eenheid bevinden; ze mogen niet voorkomen in een naamloze namespace of een private module-fragment. export static int x; is ongeldig omdat de naam interne linkage heeft.

export import M; exporteert een import opnieuw: het maakt de geëxporteerde interface van M ook beschikbaar voor importeurs van de huidige module. Een gewone import M; zorgt niet voor die re-export. In de declaratiereeks van de module-eenheid moeten imports, ook opnieuw geëxporteerde imports, vóór alle andere declaraties in die reeks staan. Als de eenheid een privéfragment heeft, geldt de regel daar afzonderlijk: imports moeten vóór alle andere declaraties in dat fragment staan. Een gewone import aan het begin van het privéfragment kan dus na declaraties uit de voorafgaande reeks staan.

Het voorbeeld vereist twee afzonderlijke bestanden. answer_value is geëxporteerd, dus main.cpp kan de functie aanroepen na import answer;. De bron op eel.is is een voortdurend bijgewerkte werkversie, geen bevroren C++23-editie; ondersteuning voor modules moet lokaal worden gecontroleerd.

Voorbeelden

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

Resultaat

42

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