WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

#include — Header einbinden

Die Direktive #include stellt den Inhalt eines Headers oder einer Quelldatei während der Vorverarbeitung bereit. Die Formen <header> und "file" verwenden unterschiedliche Suchweisen; die konkreten Suchregeln legt die Implementierung fest.

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

Syntax

#include <header>
#include "file"
#include MACRO

#include ist eine Präprozessordirektive und kein Aufruf, der zur Laufzeit ausgeführt wird. Im gewöhnlichen Fall wird sie durch den Inhalt des angegebenen Headers oder der Datei ersetzt, die ebenfalls vorverarbeitet wird. Die Direktive endet mit einem Zeilenumbruch, nicht mit einem Semikolon.

Die Form #include <header> sucht nach einem Header, während #include "file" zuerst nach einer Quelldatei sucht und bei erfolgloser Suche oder fehlender Unterstützung auf die Headersuche zurückfällt. Die Suchorte sind implementierungsabhängig: Anführungszeichen garantieren nicht, dass das aktuelle Verzeichnis durchsucht wird. Üblicherweise verwendet man <...> für Header der Implementierung und "..." für eigene Dateien.

Bei der Form #include MACRO werden Makros expandiert. Danach muss die Direktive eine der beiden gültigen Formen haben: #include <header> oder #include "file". Die Form mit Anführungszeichen kann eine Quelldatei bezeichnen. Kann der angegebene Header oder die angegebene Datei nach den Suchregeln nicht gefunden werden, ist das Programm fehlerhaft. Eine Implementierung darf das Einbinden eines importierbaren Headers durch den Import einer Header-Unit ersetzen.

Binde einen Header der Standardbibliothek außerhalb von Deklarationen und Definitionen ein, bevor du die bereitgestellten Elemente verwendest. Im Beispiel stellt <iostream> std::cout bereit. Die bereitgestellten Quellen sind ein fortlaufend aktualisierter Standardentwurf und kein eingefrorener C++23-Text.

Beispiele

#include <iostream>

int main() {
    std::cout << "Hello\n";
}

Ergebnis

Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen