Compartir a través de

#include (Directiva)

  • Artículo

Directiva de preprocesador que inserta el contenido del archivo especificado en el programa de origen en el punto donde aparece la directiva.

#include "filename"
nombre de <archivo de #include>

Parámetros

Elemento Descripción
filename Nombre de archivo del archivo que se va a incluir, precedido opcionalmente por una especificación de directorio. El nombre de archivo debe especificar un archivo existente.

Observaciones

La directiva #include provoca la sustitución de la directiva por todo el contenido del archivo especificado. El preprocesador deja de buscar en cuanto encuentra un archivo con el nombre especificado; si especifica una especificación de ruta de acceso completa e inequívoca para el archivo, el preprocesador busca solo la ruta de acceso especificada.

Nota:

La herramienta Effect-Compiler tiene un controlador de inclusión integrado mediante el modificador /I. Sin embargo, al ejecutar el compilador desde la API, puede proporcionar un controlador de inclusión personalizado mediante la implementación de la interfaz ID3DXInclude.

La diferencia entre los dos formularios de sintaxis es el orden en que el preprocesador busca archivos de encabezado cuando la ruta de acceso está incompletamente especificada, como se muestra en la tabla siguiente.

Forma de sintaxis Patrón de búsqueda del preprocesador
#include "filename" Busca el archivo de inclusión:
  1. en el mismo directorio que el archivo que contiene la directiva #include.
  2. en los directorios de los archivos que contienen una directiva #include para el archivo que contiene la directiva #include.
  3. en las rutas de acceso especificadas por la opción del compilador /I, en el orden en que se muestran.

  4. en las rutas de acceso especificadas por la variable de entorno INCLUDE, en el orden en que se muestran.

    NOTA:
    La variable de entorno INCLUDE se omite en un entorno de desarrollo. Consulte la documentación del entorno de desarrollo para obtener información sobre cómo establecer las rutas de acceso de inclusión del proyecto.
nombre de <archivo de #include> Busca el archivo de inclusión:
  1. en las rutas de acceso especificadas por la opción del compilador /I, en el orden en que se muestran.

  2. en las rutas de acceso especificadas por la variable de entorno INCLUDE, en el orden en que se muestran.

    NOTA:
    La variable de entorno INCLUDE se omite en un entorno de desarrollo. Consulte la documentación del entorno de desarrollo para obtener información sobre cómo establecer las rutas de acceso de inclusión del proyecto.

Ejemplos

En el ejemplo siguiente se hace que el preprocesador reemplace la directiva #include por el contenido de stdio.h. Dado que en el ejemplo se usa el formato de corchete angular, el preprocesador buscará el archivo solo en los directorios enumerados por la opción del compilador /I y la variable de entorno INCLUDE.

#include <stdio.h>

Consulte también