#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 :
|
| #inclure le < nom de fichier> | Recherche le fichier include :
|
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>