/headerName (지정된 헤더에서 헤더 단위 빌드)

  • 아티클

지정된 헤더 파일을 헤더 단위(.ifc 파일)로 빌드합니다.

구문

/headerName:quote header-filename
/headerName:angle header-filename

인수

header-filename
컴파일러가 헤더 단위(.ifc 파일)로 컴파일해야 하는 헤더 파일의 이름입니다.

설명

/headerName:quote 및 /headerName:angle 컴파일러 옵션은 Visual Studio 2019 버전 16.10부터 사용할 수 있습니다.

/headerName 모든 형식의 컴파일러 옵션에는 이후 컴파일러 옵션(예: /std:c++latest)이 필요합니다/std:c++20.
옵션을 지정하는 /headerName 경우 ./exportHeader

  • /headerName:quote는 동일한 규칙을 #include "header-filename" 사용하여 조회 header-filename 하고 헤더 단위(.ifc파일)로 빌드합니다.
  • /headerName:angle는 동일한 규칙을 #include <header-filename> 사용하여 조회 header-filename 하고 헤더 단위(.ifc파일)로 빌드합니다.

따옴표 또는 꺾쇠 괄호 안에 포함된 파일에 대한 경로 검색 규칙에 대한 자세한 내용은 지시문을 참조 #include 하세요.

예제

호출 m.h된 헤더 파일을 참조하는 프로젝트가 있는 경우 헤더 단위로 컴파일하는 컴파일러 옵션은 다음 예제와 유사합니다.

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

/headerName:quote 및 /headerName:angle 옵션은 플래그처럼 작동하며 인수가 필요하지 않습니다. 다음 예제는 유효합니다.

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

동일한 명령줄에서 여러 /headerName 옵션을 지정할 수 있습니다. 옵션 후의 /headerName 모든 인수는 다음 /headerName 옵션까지 따옴표 또는 꺾쇠 괄호에 대해 지정된 포함 파일 조회 규칙으로 처리됩니다. 다음 예제에서는 이전과 동일한 방식으로 이전 두 명령줄 예제로 모든 헤더를 처리합니다. 다음과 같이 #include <vector>#include "my-utilties.h"#include <iostream>#include <algorithm>지정된 것처럼 적용된 조회 규칙을 사용하여 헤더를 조회합니다.#include "a/b/my-core.h"

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

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

참고 항목

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

  1. 프로젝트의 속성 페이지 대화 상자를 엽니다. 자세한 내용은 Visual Studio에서 C++ 컴파일러 및 빌드 속성 설정을 참조하세요.

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

  3. 구성 속성>C/C++>명령줄 속성 페이지를 선택합니다.

  4. 추가 옵션 속성을 수정하여 옵션 또는 /headerName:angle 옵션을 추가하고 옵션이 적용되는 헤더 파일 이름을 추가 /headerName:quote 합니다. 그런 다음 확인을 선택하거나 적용을 선택하여 변경 내용을 저장합니다.

참고 항목

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