CKTIS / C++
Modules en interfacegrenzen in C++
Een benoemde module groepeert vertaaleenheden en maakt declaraties beschikbaar via `export`. Met `import` kunnen clients de interface gebruiken zonder een bestand tekstueel in te voegen. De modulegrens scheidt API en implementatie, maar is geen beveiligingsgrens of aparte naamruimte.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Een benoemde module is een verzameling vertaaleenheden met dezelfde modulenaam. Precies één daarvan is de primaire interface-eenheid, met als moduledeclaratie export module M;. Aan die declaratie kan een globaal modulefragment voorafgaan dat wordt ingeleid door module;. Een implementatie-eenheid die geen partitie is, wordt gedeclareerd met module M;, een implementatiepartitie met module M:Part;. export maakt declaraties beschikbaar voor clients, en import M; maakt het opzoeken van geëxporteerde namen mogelijk. Een module creëert zelf geen naamruimte.
De interfacegrens bepaalt welke namen beschikbaar zijn, niet hoe geheim de code is. Niet-geëxporteerde namen worden niet enkel door een import een gewone client-API, maar declaraties die nodig zijn om geëxporteerde entiteiten te interpreteren kunnen wel bereikbaar blijven voor de compiler. In het voorbeeld roept de client get_answer() aan, terwijl helper() in de naamloze naamruimte van de implementatie-eenheid blijft.
Partities, zoals M:Part, verdelen een module in eenheden die alleen binnen dezelfde module kunnen worden geïmporteerd met import :Part;. Interfacepartities moeten direct of indirect opnieuw worden geëxporteerd door de primaire interface. export import N; exporteert een afhankelijkheid opnieuw. Een benoemde module importeren maakt geen macro’s beschikbaar; import "header.h"; duidt een afzonderlijke header-unit aan, die macro’s beschikbaar kan maken.
Het voorbeeld bestaat uit drie afzonderlijke bestanden, niet uit één bronbestand. Bouw de interface vóór de afhankelijke eenheden en koppel alle objectbestanden. Opties voor het bouwen van modules moeten op de compiler worden afgestemd; een C++23-vlag alleen toont niet aan dat het geheel in productie werkt. De aangeleverde bron is een zich ontwikkelend werkdocument, geen vastgelegde C++23-publicatie.
Voorbeelden
// answer.cppm
export module answer;
export int get_answer();
// answer_impl.cpp
module answer;
namespace {
int helper() { return 42; }
}
int get_answer() { return helper(); }
// main.cpp
import answer;
int main() {
return get_answer() == 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.