#include : directive de précompilation
Syntaxe:
#include <fic_en_tête>
#include "fic_en_tête"
#include symbole
Description:
Demande au pré-compilateur d'ajouter, au texte en cours de compilation, les lignes du fichier 'fic_en_tête'.
Avec la première forme, 'fic_en_tête' est recherché dans le répertoire /usr/include (et éventuellement les répertoires désignés par l'option -I de la commande de compilation).
Avec la deuxième forme, 'fic_en_tête' est recherché dans le répertoire courant en premier lieu, puis dans /usr/include (et ensuite dans les répertoires éventuels désignés par l'option -I de la commande de compilation).
La toisième forme doit se ramener à l'une des deux premières, après substitution de 'symbole'.
Voici deux cas usuels d'utilisation de ce mécanisme:
- On place une définition de macro-instruction ou une déclaration dans un fichier; cette définition est alors utilisable, moyennant #include, dans plusiers modules sources.
De plus, si une modification est faite sur cette définition, elle est alors répercutée automatiquement dans tous les modules sources où elle est utilisée.
Le fichier values.h est un exemple.
- On place les prototypes des sous-programmes les plus utilisés dans un fichier. Cela permet, par simple référence à ce fichier de disposer de la déclaration de ces sous-programmes.
C'est l'utilisation du fichier stdio.h dans pratiquement tous les sous-programmes.
Voir aussi:
Exemple:
/*
On place dans le répertoire courant le fichier entete contenant:
#define BONJOUR "bonjour"
*/
#define MON_EN_TETE "entete"
#include <stdio.h> /* constante NULL, et déclaration de printf */
#include "values.h" /* pour la constante MAXINT */
#include MON_EN_TETE /* constante BONJOUR */
main() {
int * pi=NULL;
printf("*** %s ***\n", BONJOUR);
printf("*** MAXINT = %d\n", MAXINT);
}