Condividi tramite

Direttiva #include

  • Articolo

Direttiva del preprocessore che inserisce il contenuto del file specificato nel programma di origine nel punto in cui viene visualizzata la direttiva.

#include "filename"
<#include nome file>

Parametri

Elemento Descrizione
Filename Nome file del file da includere, facoltativamente preceduto da una specifica di directory. Il nome file deve specificare un file esistente.

Commenti

La direttiva #include causa la sostituzione della direttiva da parte dell'intero contenuto del file specificato. Il preprocessore interrompe la ricerca non appena trova un file con il nome specificato; se si specifica una specifica di percorso completa e non ambigua per il file, il preprocessore cerca solo il percorso specificato.

Nota

Lo strumento Effect-Compiler include un gestore di inclusione predefinito usando l'opzione /I. Tuttavia, quando si esegue il compilatore dall'API, è possibile fornire un gestore di inclusione personalizzato implementando l'interfaccia ID3DXInclude.

La differenza tra le due forme di sintassi è l'ordine in cui il preprocessore cerca i file di intestazione quando il percorso viene specificato in modo incompleto, come illustrato nella tabella seguente.

Forma di sintassi Modello di ricerca del preprocessore
#include "filename" Cerca il file di inclusione:
  1. nella stessa directory del file che contiene la direttiva #include.
  2. nelle directory di tutti i file che contengono una direttiva #include per il file che contiene la direttiva #include.
  3. nei percorsi specificati dall'opzione del compilatore /I, nell'ordine in cui sono elencati.

  4. nei percorsi specificati dalla variabile di ambiente INCLUDE, nell'ordine in cui sono elencati.

    NOTA
    La variabile di ambiente INCLUDE viene ignorata in un ambiente di sviluppo. Per informazioni su come impostare i percorsi di inclusione per il progetto, vedere la documentazione dell'ambiente di sviluppo.
<#include nome file> Cerca il file di inclusione:
  1. nei percorsi specificati dall'opzione del compilatore /I, nell'ordine in cui sono elencati.

  2. nei percorsi specificati dalla variabile di ambiente INCLUDE, nell'ordine in cui sono elencati.

    NOTA
    La variabile di ambiente INCLUDE viene ignorata in un ambiente di sviluppo. Per informazioni su come impostare i percorsi di inclusione per il progetto, vedere la documentazione dell'ambiente di sviluppo.

Esempi

Nell'esempio seguente il preprocessore sostituisce la direttiva #include con il contenuto di stdio.h. Poiché nell'esempio viene utilizzato il formato delle parentesi angolari, il preprocessore cercherà il file solo nelle directory elencate dall'opzione del compilatore /I e dalla variabile di ambiente INCLUDE.

#include <stdio.h>

Vedi anche