CKTIS / C++
#include — inclusão de cabeçalhos
A diretiva #include disponibiliza o conteúdo de um cabeçalho ou ficheiro de origem durante o pré-processamento. As formas <header> e "file" recorrem a pesquisas diferentes; as regras específicas de pesquisa são definidas pela implementação.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <header>
#include "file"
#include MACRO#include é uma diretiva de pré-processamento, não uma chamada executada durante a execução do programa. No caso habitual, é substituída pelo conteúdo do cabeçalho ou ficheiro indicado, que também é pré-processado. A diretiva termina com uma mudança de linha, não com um ponto e vírgula.
A forma #include <header> procura um cabeçalho, enquanto #include "file" procura primeiro um ficheiro de origem e, se a pesquisa não for bem-sucedida ou não for suportada, recorre à pesquisa de cabeçalhos. Os locais de pesquisa são definidos pela implementação: as aspas não garantem a pesquisa no diretório atual. Por convenção, usa-se <...> para cabeçalhos da implementação e "..." para ficheiros próprios.
A forma #include MACRO expande macros. Após a expansão, a diretiva tem de assumir uma das duas formas válidas: #include <header> ou #include "file". A forma com aspas pode indicar um ficheiro de origem. Se as regras de pesquisa não permitirem encontrar o cabeçalho ou ficheiro indicado, o programa é mal formado. Uma implementação pode substituir a inclusão de um cabeçalho importável pela importação de uma unidade de cabeçalho.
Inclui um cabeçalho da biblioteca padrão fora de declarações e definições, antes de usar os elementos que disponibiliza. No exemplo, <iostream> disponibiliza std::cout. As fontes fornecidas são um projeto de norma em evolução, não um texto C++23 fixo.
Exemplos
#include <iostream>
int main() {
std::cout << "Hello\n";
}
Resultado
Hello
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.