다음을 통해 공유

/headerUnit (헤더 단위 IFC 사용)

  • 아티클

헤더 단위를 가져옵니다. 지정된 헤더에 대한 파일(헤더 단위의 이진 표현)을 찾을 .ifc 위치를 컴파일러에 알려줍니다.

구문

/headerUnit header-filename=ifc-filename
/headerUnit:quote header-filename=ifc-filename
/headerUnit:angle header-filename=ifc-filename

인수

header-filename
컴파일러가 디스크의 파일로 확인 header-name 되는 동안 import header-name; 해당 파일을 지정하는 데 사용합니다 header-filename . 일치하면 컴파일러는 가져오기를 위해 명명된 ifc-filename 해당 IFC를 엽니다.

ifc-filename
컴파일된 헤더 단위 정보를 포함하는 파일의 이름입니다. 둘 이상의 헤더 단위를 가져오려면 각 파일에 대해 별도의 /headerUnit 옵션을 추가합니다.

설명

/headerUnit 컴파일러 옵션에는 이상 필요합니다/std:c++20.

/headerUnit 컴파일러 옵션은 Visual Studio 2019 버전 16.10 이상에서 사용할 수 있습니다.

컴파일러 import "file"; 가 제공되거나 import <file>; 이 컴파일러 옵션을 사용하면 컴파일러가 지정된 헤더 파일에 대해 컴파일된 헤더 단위(.ifc)를 찾을 수 있습니다. 이 파일의 경로는 다음과 같은 방법으로 표현할 수 있습니다.

  • /headerUnit 는 현재 디렉터리 또는 로 지정된 위치에서 컴파일된 헤더 단위를 찾습니다 ifc-filename.

  • /headerUnit:quote 와 동일한 규칙을 사용하여 컴파일된 헤더 단위 파일을 찾습니다 #include "file".

  • /headerUnit:angle 와 동일한 규칙을 사용하여 컴파일된 헤더 단위 파일을 찾습니다 #include <file>.

컴파일러는 단일 header-name 파일을 여러 .ifc 파일에 매핑할 수 없습니다. 여러 header-name 인수를 단일 .ifc인수에 매핑할 수 있습니다. 내용이 .ifc 지정한 헤더 header-name인 것처럼 가져옵니다.

이 옵션을 사용할 때 컴파일러는 암시적으로 새 전처리기를 사용하도록 설정합니다. 명령줄 /Zc:preprocessor 에 어떤 형식 /headerUnit 이 지정되어 있으면 컴파일러가 명령줄에 추가합니다. 암시적 /Zc:preprocessor옵트아웃하려면 다음을 지정합니다. /Zc:preprocessor-

새 전처리기를 사용하지 않도록 설정하지만 컴파일하는 파일이 헤더 단위를 가져오면 컴파일러에서 오류를 보고합니다.

예제

이 표에 나열된 대로 두 개의 헤더 파일과 해당 헤더 단위를 참조하는 프로젝트가 제공됩니다.

헤더 파일 IFC 파일
C:\utils\util.h C:\util.h.ifc
C:\app\app.h C:\app\app.h.ifc

이러한 특정 헤더 파일에 대한 헤더 단위를 참조하는 컴파일러 옵션은 다음과 같습니다.

cl ... /std:c++latest /headerUnit C:\utils\util.h=C:\util.h.ifc /headerUnit:quote app.h=app.h.ifc

Visual Studio 개발 환경에서 이 컴파일러 옵션을 설정하려면

일반적으로 Visual Studio 개발 환경에서는 설정하면 안 됩니다. 빌드 시스템에 의해 설정됩니다.

참고 항목

/exportHeader(헤더 단위 만들기)
/headerName (지정된 헤더에서 헤더 단위 만들기)
/reference(명명된 모듈 IFC 사용)
/translateInclude(include 지시문을 import 지시문으로 변환)