Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje