/source-charset
(원본 문자 집합 설정)
이 옵션을 사용하면 실행 파일에 대한 원본 문자 집합을 지정할 수 있습니다.
구문
/source-charset:
[IANA_name
|.CPID
]
인수
IANA_name
IANA에서 정의한 문자 집합 이름입니다.
.CPID
코드 페이지 식별자는 문자 앞에 오는 10진수입니다 .
.
설명
이 옵션을 사용하여 /source-charset
원본 파일에 기본 원본 문자 집합에 표시되지 않는 문자가 포함될 때 사용할 확장 소스 문자 집합을 지정할 수 있습니다. 원본 문자 집합은 프로그램의 원본 텍스트를 해석하는 데 사용되는 인코딩입니다. 컴파일하기 전에 전처리 단계에 대한 입력으로 사용되는 내부 표현으로 변환됩니다. 그런 다음 내부 표현이 실행 파일에 문자열 및 문자 값을 저장하도록 실행 문자 집합으로 변환됩니다. IANA 또는 ISO 문자 집합 이름을 사용하거나 점(.
) 뒤의 3~5개 숫자를 사용할 수 있습니다(사용할 문자 집합의 코드 페이지 식별자 지정). 지원되는 코드 페이지 식별자 및 문자 집합 이름 목록은 코드 페이지 식별자를 참조하세요.
기본적으로 Visual Studio에서는 바이트 순서 표시를 검색하여 원본 파일이 인코딩된 유니코드 형식(예: UTF-16 또는 UTF-8)인지 확인합니다. 바이트 순서 표시가 없으면 문자 집합 이름 또는 /utf-8
코드 페이지를 지정하는 옵션을 사용하지 /source-charset
않는 한 소스 파일이 현재 사용자 코드 페이지에서 인코딩된 것으로 가정합니다. Visual Studio를 사용하면 C++ 소스 코드를 여러 문자 인코딩으로 저장할 수 있습니다. 원본 및 실행 문자 집합에 대한 자세한 내용은 언어 설명서의 문자 집합을 참조하세요.
제공하는 원본 문자 집합은 7비트 ASCII 문자를 문자 집합의 동일한 코드 포인트에 매핑해야 합니다. 그렇지 않으면 많은 컴파일 오류가 뒤따를 수 있습니다. 원본 문자 집합에는 UTF-8의 확장된 유니코드 문자 집합에 대한 매핑도 있어야 합니다. UTF-8에 해당하는 문자가 없는 문자는 구현별 대체 문자로 표시됩니다. Microsoft 컴파일러는 이러한 문자에 물음표를 사용합니다.
원본 문자 집합과 실행 문자 집합을 모두 UTF-8로 설정하려면 /utf-8
컴파일러 옵션을 바로가기로 사용할 수 있습니다. 명령줄의 /source-charset:utf-8 /execution-charset:utf-8
과 동등합니다. 이러한 옵션은 기본적으로 /validate-charset
옵션도 사용하도록 설정합니다.
Visual Studio 개발 환경에서 이 컴파일러 옵션을 설정하려면
프로젝트에 대한 속성 페이지 대화 상자를 엽니다. 자세한 내용은 Visual Studio에서 C++ 컴파일러 및 빌드 속성 설정을 참조하세요.
구성 속성>C/C++>명령줄 속성 페이지를 선택합니다.
추가 옵션에서
/source-charset
옵션을 추가하고 원하는 인코딩을 지정합니다.확인을 선택하여 변경 내용을 저장합니다.
참고 항목
MSVC 컴파일러 옵션
MSVC 컴파일러 명령줄 구문
/execution-charset
(실행 문자 집합 설정)
/utf-8
(원본 및 실행 문자 집합을 UTF-8로 설정)
/validate-charset
(호환 문자 유효성 검사)