Directiva  #include

§1  Sinopsis

La directiva #include carga determinados ficheros denominados, ficheros de inclusión (include files), ficheros de cabecera (header files) o simplemente cabeceras, y los inserta en el código fuente (en el punto de la directiva) que desde ese momento queda sustituida por el texto contenido en el fichero.

§2  Sintaxis

Tiene tres versiones:

#include <nombre_de_cabecera>
#include "nombre_de_cabecera"
#include macro_identificador

Ejemplos

#include <stdio.h>
#include "D:\Cabeceras\Cpp\versiones.h"
#include VERSIONUS
.....
#define VESIONUS "D:\Cabeceras\Cpp\VersionUs."

§3  Descripción

En la primera y la segunda versión de la sintaxis no se intenta ninguna macro-sustitución. En otras palabras: nombre_de_cabecera debe ser un nombre válido de fichero con una extensión. Tradicionalmente esta extensión es .h (por "header").

La diferencia entre ambas se limita al mecanismo empleado para localizar el fichero a incluir:

• La primera forma supone que el fichero, generalmente con la extensión .h, será buscado en el directorio de cabeceras estándar (generalmente  /usr/include/CC).

• La segunda forma se utiliza para cualquier fichero situado en directorio distinto al de cabeceras estándar. Debe incluir de forma explícita su "paht" para que pueda ser cargado por el preprocesador. La ausencia de "path" supone el directorio actual (donde está el fuente que se compila). En estos casos solo se busca en el directorio indicado.

• La tercera versión supone que el primer carácter no blanco después de #include no es < (60) ni " (34) y que hay definida una macro que puede transformar macro_identificador en un nombre de cabecera válido en el formato <nombre_de_cabecera> o "nombre_de_cabecera".

En cualquiera de los tres casos el resultado es el mismo. El preprocesador elimina la línea #include y la reemplaza con el texto completo del fichero de cabecera en dicho punto [1]. Por tradición los #include se colocan siempre al comienzo del fichero fuente, pero desde luego su situación tiene influencia en el ámbito y duración de los identificadores que haya en el fichero a incluir.

  Inicio.

---

[1]  El fichero fuente no es modificado, solo la representación en memoria del mismo y en los posibles ficheros intermedios utilizados por el compilador.