Partilhar via

Diretiva #include

  • Artigo

Diretiva de pré-processador que insere o conteúdo do arquivo especificado no programa de origem no ponto em que a diretiva é exibida.

#include "filename"
<#include nome do arquivo>

Parâmetros

Item Descrição
filename Nome do arquivo a ser incluído, opcionalmente precedido por uma especificação de diretório. O nome do arquivo deve especificar um arquivo existente.

Comentários

A diretiva #include causa a substituição da diretiva pelo conteúdo inteiro do arquivo especificado. O pré-processador para de pesquisar assim que encontra um arquivo com o nome especificado; se você especificar uma especificação de caminho completa e inequívoca para o arquivo, o pré-processador pesquisará apenas o caminho especificado.

Observação

A Effect-Compiler Tool tem um manipulador de inclusão interno usando a opção /I. No entanto, ao executar o compilador da API, você pode fornecer um manipulador de inclusão personalizado implementando a interface ID3DXInclude.

A diferença entre os dois formulários de sintaxe é a ordem na qual o pré-processador pesquisa arquivos de cabeçalho quando o caminho é especificado incompletamente, conforme mostrado na tabela a seguir.

Formato de sintaxe Padrão de pesquisa de pré-processador
#include "filename" Pesquisa o arquivo de inclusão:
  1. no mesmo diretório que o arquivo que contém a diretiva #include.
  2. nos diretórios de todos os arquivos que contêm uma diretiva #include para o arquivo que contém a diretiva #include.
  3. em caminhos especificados pela opção do compilador /I, na ordem em que estão listados.

  4. em caminhos especificados pela variável de ambiente INCLUDE, na ordem em que estão listados.

    OBSERVAÇÃO:
    A variável de ambiente INCLUDE é ignorada em um ambiente de desenvolvimento. Consulte a documentação do ambiente de desenvolvimento para obter informações sobre como definir os caminhos de inclusão para seu projeto.
<#include nome do arquivo> Pesquisa o arquivo de inclusão:
  1. em caminhos especificados pela opção do compilador /I, na ordem em que estão listados.

  2. em caminhos especificados pela variável de ambiente INCLUDE, na ordem em que estão listados.

    OBSERVAÇÃO:
    A variável de ambiente INCLUDE é ignorada em um ambiente de desenvolvimento. Consulte a documentação do ambiente de desenvolvimento para obter informações sobre como definir os caminhos de inclusão para seu projeto.

Exemplos

O exemplo a seguir faz com que o pré-processador substitua a diretiva #include pelo conteúdo de stdio.h. Como o exemplo usa o formato de colchete angular, o pré-processador pesquisará o arquivo somente nos diretórios listados pela opção do compilador /I e pela variável de ambiente INCLUDE.

#include <stdio.h>

Confira também