CKTIS / C++
import — import modulů a hlavičkových jednotek
`import` zpřístupňuje exportované rozhraní pojmenovaného modulu, partitionu aktuálního modulu nebo hlavičkovou jednotku. Na rozdíl od `#include` nevkládá obsah jako text; import pojmenovaného modulu nezpřístupňuje makra.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
import module_name;
import :partition_name;
import <header>;
import "header";
export import module_name;import arithmetic; importuje rozhraní pojmenovaného modulu: jeho exportovaná jména jsou po deklaraci importu dostupná pro vyhledávání jmen. Import nevytváří jmenný prostor ani textově nevkládá soubor. Název modulu není název souboru.
import :partition_name; importuje partition téhož modulu a může se objevit až po jeho deklaraci module. import <header>; a import "header"; importují hlavičkovou jednotku, tedy samostatnou překladovou jednotku vytvořenou z importovatelné hlavičky. Přímý import hlavičkové jednotky může zpřístupnit makra; import pojmenovaného modulu nikoli.
Deklarace importu musí být v rozsahu globálního jmenného prostoru, nikoli uvnitř funkce nebo pojmenovaného jmenného prostoru. V jednotce modulu musí importy v příslušné sekvenci deklarací předcházet ostatním deklaracím. export import module_name; v rozhraní modulu import znovu exportuje a zpřístupňuje jej uživatelům tohoto rozhraní. Cyklické závislosti mezi rozhraními jsou zakázány.
Příklad se skládá ze dvou souborů: arithmetic.cppm exportuje square a main.cpp importuje modul a ověřuje výsledek při překladu. Nic nevypisuje a měl by skončit se stavem 0. Překladač a buildovací systém musí podporovat moduly a jejich závislosti; samotný příznak C++23 nedokládá úspěšné sestavení ani spuštění. Uvedený web obsahuje průběžně se vyvíjející pracovní návrh, nikoli definitivní text C++23.
Příklady
// 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;
}
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.