#include (directive)

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

#inclure «nom de fichier»
#inclure le nom de fichier <>

Paramètres

Élément Description
extension Nom 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 le contenu entier du fichier spécifié. Le préprocesseur arrête 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 d’accès spécifié.

Notes

L' outil Effect-compiler est doté d’un gestionnaire d’inclusion intégré utilisant le 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 de syntaxe 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
#inclure le " nom de fichier" 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 d’accès spécifiés par l’option du compilateur/I, dans l’ordre dans lequel ils sont répertoriés.
  4. dans les chemins d’accès spécifiés par la variable d’environnement INCLUDe, dans l’ordre dans lequel ils sont répertoriés.

    [!NOTE]
    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 façon de définir les chemins d’accès include pour votre projet.


#inclure le < nom de fichier> Recherche le fichier include :
  1. dans les chemins d’accès spécifiés par l’option du compilateur/I, dans l’ordre dans lequel ils sont répertoriés.
  2. dans les chemins d’accès spécifiés par la variable d’environnement INCLUDe, dans l’ordre dans lequel ils sont répertoriés.

    [!NOTE]
    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 façon de définir les chemins d’accès include pour votre projet.


Exemples

L’exemple suivant fait en sorte que le préprocesseur remplace la # directive include par le contenu de stdio. h. Étant donné que l’exemple utilise le format Chevron, le préprocesseur recherche le fichier uniquement dans les répertoires listés par l’option de compilateur/I et la variable d’environnement INCLUDe.

#include <stdio.h>

Voir aussi