comment pragma

  • 아티클

주석 기록을 개체 파일 또는 실행 파일에 배치합니다.

구문

#pragma comment(comment-type [ , "comment-string" ] )

설명

주석 유형은 주석 레코드의 형식을 지정하는 미리 정의된 식별자 중 하나입니다. 선택적 주석 문자열 은 일부 주석 형식에 대한 추가 정보를 제공하는 문자열 리터럴입니다. 주석 문자열은 문자열 리터럴이므로 이스케이프 문자, 포함된 따옴표(") 및 연결을 사용할 때 문자열 리터럴에 대한 모든 규칙을 준수합니다.

compiler

컴파일러의 이름 및 버전 이름을 개체 파일에 배치합니다. 이 주석 기록은 링커에 의해 무시됩니다. 이 레코드 형식에 대한 주석 문자열 매개 변수를 제공하면 컴파일러가 경고를 생성합니다.

lib

라이브러리 검색 기록을 개체 파일에 배치합니다. 이 주석 형식에는 링커가 검색할 라이브러리의 이름(및 경로)이 있는 주석 문자열 매개 변수가 함께 있어야 합니다. 라이브러리 이름은 개체 파일의 기본 라이브러리 검색 레코드를 따릅니다. 링커는 명령을 사용하여 /nodefaultlib라이브러리를 지정하지 않는 한 명령줄에서 지정한 것과 동일한 방식으로 이 라이브러리를 검색합니다. 동일한 원본 파일에 여러 라이브러리 검색 레코드를 배치할 수 있습니다. 각 레코드는 원본 파일에서 찾은 순서와 동일한 순서로 개체 파일에 표시됩니다.

기본 라이브러리 및 추가된 라이브러리의 순서가 중요한 경우 스위치를 사용하여 /Zl 컴파일하면 기본 라이브러리 이름이 개체 모듈에 배치되지 않습니다. 그런 다음 두 번째 주석 pragma 을 사용하여 추가된 라이브러리 뒤에 기본 라이브러리의 이름을 삽입할 수 있습니다. 이러한 pragma 지시문과 함께 나열된 라이브러리는 소스 코드에서 찾은 순서대로 개체 모듈에 표시됩니다.

링커

개체 파일에 링커 옵션을 배치합니다. 이 주석 형식을 이용하여 명령줄에 주석을 전달하거나 개발 환경에 지정하는 대신 링커 옵션을 지정할 수 있습니다. 예를 들어, /include 옵션을 지정하면 기호를 포함하도록 할 수 있습니다.

#pragma comment(linker, "/include:__mySymbol")

링커 식별자에는 다음(주석 형식) 링커 옵션만 전달할 수 있습니다.

user

일반 주석을 개체 파일에 배치합니다. 주석 문자열 매개 변수에는 주석의 텍스트가 포함됩니다. 이 주석 기록은 링커에 의해 무시됩니다.

예제

다음은 pragma 링커가 EMAPI를 검색하도록 합니다. 연결하는 동안 LIB 라이브러리. 링커는 먼저 현재 작업 디렉터리에서 검색한 다음 LIB 환경 변수에 지정된 경로에서 검색합니다.

#pragma comment( lib, "emapi" )

그러면 pragma 컴파일러가 개체 파일에 컴파일러의 이름과 버전 번호를 배치합니다.

#pragma comment( compiler )

주석 문자열 매개 변수를 사용하는 주석의 경우 매크로가 문자열 리터럴로 확장되는 한 문자열 리터럴을 사용하는 모든 위치에서 매크로를 사용할 수 있습니다. 문자열 리터럴에 확장되는 문자열 리터럴 및 매크로의 조합을 연결할 수도 있습니다. 예를 들어, 다음 문을 사용할 수 있습니다.

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )

참고 항목

Pragma 지시문 및 __pragma_Pragma 키워드(keyword)