CKTIS / C++
Модули и граници на интерфейса в C++
Именуван модул групира преводни единици и предоставя декларации чрез `export`. `import` позволява на клиентите да използват интерфейса му, без файлът да се включва текстово. Границата на модула отделя API от реализацията, но не е граница на сигурност или отделно пространство от имена.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
export module M;
export int answer();
// Separate implementation unit:
module M;
int answer() { return 42; }
// Separate importing translation unit:
import M;Именуваният модул е колекция от преводни единици с едно и също име на модул. Точно една от тях е основната интерфейсна единица с модулна декларация export module M;. Тази декларация може да бъде предшествана от глобален модулен фрагмент, въведен с module;. Единица за реализация, която не е дял, се декларира с module M;, а дял за реализация — с module M:Part;. export предоставя декларации на клиентите, а import M; позволява търсене на експортираните имена. Сам по себе си модулът не създава пространство от имена.
Интерфейсната граница определя достъпността на имената, а не поверителността на кода. Неекспортираните имена не се превръщат в обикновен клиентски API само чрез импорт, но декларациите, необходими за интерпретирането на експортираните същности, все пак могат да бъдат достижими за компилатора. В примера клиентът извиква get_answer(), докато helper() остава в неименуваното пространство от имена на единицата за реализация.
Дялове, например M:Part, разделят модула на единици, които могат да се импортират само в рамките на същия модул чрез import :Part;. Основният интерфейс трябва пряко или непряко да реекспортира интерфейсните дялове. export import N; реекспортира зависимост. Импортирането на именуван модул не предоставя макроси; import "header.h"; обозначава отделна единица за заглавен файл, която може да предоставя макроси.
Примерът се състои от три отделни файла, а не от един изходен файл. Изградете интерфейса преди зависимите единици и свържете всички обектни файлове. Опциите за изграждане на модули трябва да се изберат според компилатора; флаг C++23 сам по себе си не потвърждава работа в продукционна среда. Посоченият източник е работен проект, който продължава да се развива, а не окончателно издание на C++23.
Примери
// 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;
}
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.