/execution-charset(실행 문자 집합 설정)

이 옵션을 사용하면 실행 파일의 실행 문자 집합을 지정할 수 있습니다.

구문

/execution-charset:[IANA_name | .CPID]

인수

IANA_name
IANA에서 정의한 문자 집합 이름입니다.

.CPID
앞에 . 문자가 오는 코드 페이지 식별자입니다.

설명

/execution-charset 옵션을 사용하여 실행 문자 집합을 지정할 수 있습니다. 실행 문자 집합은 모든 전처리 단계 이후 컴파일 단계에 입력되는 프로그램 텍스트에 인코딩으로 사용됩니다. 이 문자 집합은 컴파일된 코드에서 문자열이나 문자 리터럴의 내부 표현에 사용됩니다. 원본 파일에 기본 실행 문자 집합으로 표현할 수 없는 문자가 포함되어 있는 경우 이 옵션을 설정하여 사용할 확장 실행 문자 집합을 지정합니다. IANA 또는 ISO 문자 집합 이름을 사용하거나 점(.) 뒤의 3~5개 숫자를 사용할 수 있습니다(사용할 문자 집합의 코드 페이지 식별자 지정). 지원되는 코드 페이지 식별자 및 문자 집합 이름 목록은 코드 페이지 식별자를 참조하세요.

기본적으로 Visual Studio에서는 바이트 순서 표시를 검색하여 원본 파일이 인코딩된 유니코드 형식(예: UTF-16 또는 UTF-8)인지 확인합니다. /source-charset 또는 /utf-8 옵션을 사용하여 문자 집합 이름이나 코드 페이지를 지정하지 않은 경우 바이트 순서 표시를 찾을 수 없으면 원본 파일이 현재 사용자 코드 페이지로 인코딩된 것으로 가정합니다. Visual Studio를 사용하면 C++ 소스 코드를 여러 문자 인코딩으로 저장할 수 있습니다. 원본 및 실행 문자 집합에 대한 자세한 내용은 언어 설명서의 문자 집합을 참조하세요.

원본 문자 집합과 실행 문자 집합을 모두 UTF-8로 설정하려면 /utf-8 컴파일러 옵션을 바로가기로 사용할 수 있습니다. 명령줄의 /source-charset:utf-8 /execution-charset:utf-8과 동등합니다. 이러한 옵션은 기본적으로 /validate-charset 옵션도 사용하도록 설정합니다.

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

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

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

  3. 추가 옵션에서 /execution-charset 옵션을 추가하고 원하는 인코딩을 지정합니다.

  4. 확인을 선택하여 변경 내용을 저장합니다.

참고 항목

MSVC 컴파일러 옵션
MSVC 컴파일러 명령줄 구문
/source-charset(원본 문자 집합 설정)
/utf-8(원본 및 실행 문자 집합을 UTF-8로 설정)
/validate-charset(호환 문자 유효성 검사)