/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 개발 환경에서 이 컴파일러 옵션을 설정하려면

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

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

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

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

참고 항목

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