Partager via

#include, directive

  • Article

Directive de préprocesseur qui insère le contenu du fichier spécifié dans le programme source au point où la directive apparaît.

#include « filename »
nom de fichier< #include>

Paramètres

Élément Description
filename Nom de fichier du fichier à inclure, éventuellement précédé d’une spécification de répertoire. Le nom de fichier doit spécifier un fichier existant.

Remarques

La directive #include provoque le remplacement de la directive par l’intégralité du contenu du fichier spécifié. Le préprocesseur cesse de rechercher dès qu’il trouve un fichier avec le nom spécifié ; si vous spécifiez une spécification de chemin d’accès complète et non ambiguë pour le fichier, le préprocesseur recherche uniquement le chemin spécifié.

Notes

L’outil Effect-Compiler Tool dispose d’un gestionnaire d’include intégré à l’aide du commutateur /I. Toutefois, lors de l’exécution du compilateur à partir de l’API, vous pouvez fournir un gestionnaire include personnalisé en implémentant l’interface ID3DXInclude.

La différence entre les deux formes syntaxiques est l’ordre dans lequel le préprocesseur recherche les fichiers d’en-tête lorsque le chemin d’accès est spécifié de manière incomplète, comme indiqué dans le tableau suivant.

Forme syntaxique Modèle de recherche de préprocesseur
#include «filename» Recherche le fichier include :
  1. dans le même répertoire que le fichier qui contient la directive #include.
  2. dans les répertoires de tous les fichiers qui contiennent une directive #include pour le fichier qui contient la directive #include.
  3. dans les chemins spécifiés par l’option du compilateur /I, dans l’ordre dans lequel ils sont répertoriés.

  4. dans les chemins spécifiés par la variable d’environnement INCLUDE, dans l’ordre dans lequel ils sont répertoriés.

    REMARQUE :
    La variable d’environnement INCLUDE est ignorée dans un environnement de développement. Reportez-vous à la documentation de votre environnement de développement pour plus d’informations sur la définition des chemins d’accès include pour votre projet.
nom de fichier< #include> Recherche le fichier include :
  1. dans les chemins spécifiés par l’option du compilateur /I, dans l’ordre dans lequel ils sont répertoriés.

  2. dans les chemins spécifiés par la variable d’environnement INCLUDE, dans l’ordre dans lequel ils sont répertoriés.

    REMARQUE :
    La variable d’environnement INCLUDE est ignorée dans un environnement de développement. Reportez-vous à la documentation de votre environnement de développement pour plus d’informations sur la définition des chemins d’accès include pour votre projet.

Exemples

Dans l’exemple suivant, le préprocesseur remplace la directive #include par le contenu de stdio.h. Étant donné que l’exemple utilise le format de crochetage, le préprocesseur recherche le fichier uniquement dans les répertoires répertoriés par l’option de compilateur /I et la variable d’environnement INCLUDE.

#include <stdio.h>

Voir aussi