CKTIS / C++
#include — inclusione degli header
La direttiva #include rende disponibile durante la preelaborazione il contenuto di un header o di un file sorgente. Le forme <header> e "file" usano ricerche diverse; le regole di ricerca specifiche sono definite dall’implementazione.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <header>
#include "file"
#include MACRO#include è una direttiva di preelaborazione, non una chiamata eseguita durante l’esecuzione del programma. Di norma viene sostituita dal contenuto dell’header o del file specificato, anch’esso sottoposto a preelaborazione. La direttiva termina con un carattere di nuova riga, non con un punto e virgola.
La forma #include <header> cerca un header, mentre #include "file" cerca prima un file sorgente e, se la ricerca non riesce o non è supportata, ripiega sulla ricerca di un header. Le posizioni di ricerca sono definite dall’implementazione: le virgolette non garantiscono che venga cercata la directory corrente. Per convenzione, si usa <...> per gli header dell’implementazione e "..." per i propri file.
La forma #include MACRO espande le macro. Dopo l’espansione, la direttiva deve assumere una delle due forme valide: #include <header> o #include "file". La forma con le virgolette può indicare un file sorgente. Se le regole di ricerca non consentono di trovare l’header o il file indicato, il programma è mal formato. Un’implementazione può sostituire l’inclusione di un header importabile con l’importazione di un’unità header.
Includi un header della libreria standard al di fuori di dichiarazioni e definizioni, prima di usare gli elementi che fornisce. Nell’esempio, <iostream> rende disponibile std::cout. Le fonti fornite sono una bozza dello standard in evoluzione, non un testo C++23 congelato.
Esempi
#include <iostream>
int main() {
std::cout << "Hello\n";
}
Risultato
Hello
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.