다음을 통해 공유


#include 지시문

지시문이 나타나는 지점에서 지정된 파일의 내용을 원본 프로그램에 삽입하는 전처리기 지시문입니다.

#include "filename"
#include <filename>

매개 변수

항목 설명
filename 포함할 파일의 파일 이름으로, 경우에 따라 디렉터리 사양이 앞에 옵니다. filename은 기존 파일을 지정해야 합니다.

설명

#include 지시문은 지정된 파일의 전체 내용으로 지시문을 대체합니다. 전처리기는 지정된 이름을 갖는 파일을 찾는 즉시 검색을 중지합니다. 파일에 대한 완전하고 명확한 경로 사양을 지정하면 전처리기가 지정된 경로만 검색합니다.

참고

Effect-Compiler 도구에는 /I 스위치를 사용하는 기본 제공 include 처리기가 있습니다. 그러나 API에서 컴파일러를 실행할 때 ID3DXInclude 인터페이스를 구현하여 사용자 지정된 include 처리기를 제공할 수 있습니다.

다음 표에 나와 있는 것처럼 경로가 불완전하게 지정되어 있을 경우 두 구문 형식 간의 차이는 전처리기가 헤더 파일을 검색하는 순서입니다.

구문 형식 전처리기 검색 패턴
#include "filename" 다음 위치에서 include 파일을 검색합니다.
  1. #include 지시문이 포함된 파일과 동일한 디렉터리
  2. #include 지시문이 포함된 파일에 대한 #include 지시문이 포함된 파일의 디렉터리
  3. /I 컴파일러 옵션으로 지정된 경로(나열되는 순서대로)
  4. INCLUDE 환경 변수가 지정하는 경로(나열되는 순서대로)

    참고:
    INCLUDE 환경 변수는 개발 환경에서 무시됩니다. 프로젝트에 대한 include 경로를 설정하는 방법에 대한 자세한 내용은 개발 환경 설명서를 참조하세요.


#include <filename> 다음 위치에서 include 파일을 검색합니다.
  1. /I 컴파일러 옵션으로 지정된 경로(나열되는 순서대로)
  2. INCLUDE 환경 변수가 지정하는 경로(나열되는 순서대로)

    참고:
    INCLUDE 환경 변수는 개발 환경에서 무시됩니다. 프로젝트에 대한 include 경로를 설정하는 방법에 대한 자세한 내용은 개발 환경 설명서를 참조하세요.


예제

다음 예제에서는 전처리기가 stdio.h의 내용으로 #include 지시문을 바꿉니다. 이 예제에서는 꺾쇠 괄호 형식을 사용하므로 전처리기는 /I 컴파일러 옵션 및 INCLUDE 환경 변수가 나열하는 디렉터리에서만 파일을 검색합니다.

#include <stdio.h>

추가 정보