/exportHeader (헤더 단위 만들기)

입력 인수로 지정된 헤더 단위를 만들도록 컴파일러에 지시합니다. 컴파일러는 헤더 단위를 IFC(.ifc) 파일로 생성합니다.

구문

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

인수

인수 /exportHeader 는 /headerName 내보낼 헤더 파일의 이름을 header-name지정하는 명령줄 옵션입니다.

설명

/exportHeader 는 Visual Studio 2019 버전 16.10부터 사용할 수 있습니다.

/exportHeader 컴파일러 옵션을 사용하려면 이상 컴파일러 옵션(예: /std:c++latest)을 사용하도록 설정 /std:c++20 해야 합니다.

하나의 /exportHeader 컴파일러 옵션은 빌드에 필요한 만큼의 헤더 이름 인수를 지정할 수 있습니다. 별도로 지정할 필요가 없습니다.

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

기본적으로 컴파일러는 헤더 단위가 컴파일될 때 개체 파일을 생성하지 않습니다. 개체 파일을 생성하려면 컴파일러 옵션을 지정 /Fo 합니다. 자세한 내용은 (개체 파일 이름)을 참조 /Fo 하세요.

보완 옵션을 /showResolvedHeader사용하는 것이 유용할 수 있습니다. 이 /showResolvedHeader 옵션은 인수가 확인되는 파일 header-name 의 절대 경로를 출력합니다.

/exportHeader 에서 여러 /MP입력을 한 번에 처리할 수 있습니다. 각 컴파일에 대해 별도의 .ifc 파일을 만드는 데 사용하는 /ifcOutput <directory> 것이 좋습니다.

예제

다음과 같은 <vector> 헤더 단위를 빌드하려면 다음을 수행합니다.

cl . . . /std:c++latest /exportHeader /headerName:angle vector

다음과 같이 "utils/util.h" 로컬 프로젝트 헤더를 빌드합니다.

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

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

일반적으로 헤더 파일에 다른 확장을 사용하지 않는 한 Visual Studio 개발 환경에서 이 옵션을 설정해서는 안 됩니다. 기본적으로 빌드 시스템은 확장명이 있거나 확장명이 없는 컴파일된 파일에 .h 이 옵션을 적용합니다.

1. IDE의 /exportHeader 파일에 옵션을 명시적으로 적용하려면 솔루션 탐색기 파일을 선택합니다. 마우스 오른쪽 단추를 클릭하여 상황에 맞는 메뉴를 열고 속성을 선택하여 속성 페이지 대화 상자를 엽니다.

2. 구성 드롭다운을 모든 구성으로 설정합니다. 플랫폼 드롭다운을 모든 플랫폼으로 설정합니다.

3. 구성 속성>C/C++>고급 속성 페이지를 엽니다.

4. 드롭다운 컨트롤을 사용하여 C++ 헤더 단위(/exportHeader)로 컴파일하도록 Compile As 속성을 수정합니다. 확인을 선택하거나 적용을 선택하여 변경 내용을 저장합니다.

참고 항목

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