#include

Remonter à Le préprocesseur - Index

Syntaxe

#include <header_name>
#include "header_name"
#include <macro_definition>

Pour des informations sur la syntaxe #include avec BCC64, voir Différences C++ Builder Windows 64 bits.

Description

La directive #include intègre d'autres fichiers nommés (appelés fichiers d'inclusion, fichiers en-tête ou en-têtes) dans le code source. La syntaxe se présente sous trois versions :

• Les deux premières versions impliquent qu'aucun développement de macro ne sera tenté. En d'autres termes, header_name ne sera jamais analysé pour les identificateurs de macros. header_name doit être un nom de fichier valide avec une extension (traditionnellement .h pour les fichiers en-tête), et éventuellement un nom de chemin et des délimiteurs de chemins.
• La troisième version suppose que ni < ni " n'apparaît en tant que premier caractère non espace après #include. En outre, elle suppose l'existence d'une définition de macro qui développera l'identificateur de macro en un nom d'en-tête valide, délimité, au format <header_name> ou "header_name".

Le préprocesseur retire la ligne #include et la remplace conceptuellement par le texte entier du fichier d'inclusion au même endroit dans le code source. Le code source lui-même n'est pas modifié, mais le compilateur "voit" le texte agrandi. L'emplacement de #include peut néanmoins influencer la portée et la durée des identificateurs du fichier inclus.

Si vous placez un chemin explicite dans header_name, seul ce répertoire sera soumis à la recherche.

La différence entre les formats <header_name> et "header_name" réside dans l'algorithme de recherche employé en essayant de localiser le fichier d'inclusion :

Forme de la syntaxe	Algorithme de recherche
Forme Guillemets	La version "header_name" spécifie un fichier d'inclusion fourni par l'utilisateur ; le fichier est recherché dans l'ordre suivant : Le répertoire du fichier contenant l'instruction #include. Les répertoires des fichiers qui incluent (#include) ce fichier. Le répertoire en cours. Le chemin spécifié par l'option Chemin de recherche des fichiers d'inclusion (-I).
Forme Crochets angulaires	La version <header_name> spécifie un fichier d'inclusion standard. La recherche est effectuée successivement dans chacun des répertoires d'inclusion dans l'ordre où ils ont été définis par l'option Chemin de recherche des fichiers d'inclusion (-I). Si le fichier ne réside dans aucun des répertoires par défaut, un message d'erreur est émis.

Voir aussi

• Utilisation des fichiers d'inclusion