Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes