Partilhar via


/source-charset (definir conjunto de caracteres de origem)

Essa opção permite especificar o conjunto de caracteres de origem para o executável.

Sintaxe

/source-charset:[IANA_name | .CPID]

Argumentos

IANA_name
O nome do conjunto de caracteres definido pela IANA.

.CPID
O identificador da página de código como um número decimal, precedido por um caractere ..

Comentários

Você pode usar a opção /source-charset para especificar um conjunto de caracteres de origem estendido a ser usado quando seus arquivos de origem incluírem caracteres que não são representados no conjunto de caracteres de origem básico. O conjunto de caracteres de origem é a codificação usada para interpretar o texto de origem do programa. Ele é convertido na representação interna usada como entrada nas fases de pré-processamento antes da compilação. Em seguida, a representação interna é convertida no conjunto de caracteres de execução para armazenar valores de cadeia de caracteres e caracteres no executável. Você pode usar o nome do conjunto de caracteres IANA ou ISO ou um ponto (.) seguido de 3 a 5 dígitos decimais que especificam o identificador de página de código do conjunto de caracteres a ser usado. Para obter uma lista de identificadores de página de código com suporte e nomes de conjunto de caracteres, confira Identificadores de Página de Código.

Por padrão, o Visual Studio detecta uma marca de ordem de byte para determinar se o arquivo de origem está codificado em um formato Unicode, por exemplo, UTF-16 ou UTF-8. Se nenhuma marca de ordem de byte for encontrada, ele pressupõe que o arquivo de origem esteja codificado na página de código do usuário atual, a menos que você use a opção /source-charset ou /utf-8 para especificar um nome de conjunto de caracteres ou uma página de código. O Visual Studio permite que você salve o código-fonte do C++ em qualquer uma das diversas codificações de caracteres. Para obter mais informações sobre conjuntos de caracteres de origem e execução, confira Conjuntos de caracteres na documentação da linguagem.

O conjunto de caracteres de origem que você fornecer deverá mapear os caracteres ASCII de 7 bits para os mesmos pontos de código no conjunto de caracteres ou haverá a probabilidade de muitos erros de compilação. Seu conjunto de caracteres de origem também deverá ter um mapeamento para o conjunto de caracteres Unicode estendido UTF-8. Os caracteres que não têm equivalente em UTF-8 serão representados por um substituto específico da implementação. O compilador da Microsoft usa um ponto de interrogação para esses caracteres.

Se você quiser definir o conjunto de caracteres de origem e o conjunto de caracteres de execução como UTF-8, poderá usar a opção do compilador /utf-8 como um atalho. Ela é equivalente à /source-charset:utf-8 /execution-charset:utf-8 na linha de comando. Qualquer uma dessas opções também habilita a opção /validate-charset por padrão.

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do seu projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Selecione a página de propriedades Propriedades de Configuração>C/C++>Linha de Comando.

  3. Em Opções Adicionais, adicione a opção /source-charset e especifique a codificação de sua preferência.

  4. Escolha OK para salvar suas alterações.

Confira também

Opções do compilador MSVC
Sintaxe de linha de comando do compilador MSVC
/execution-charset (Definir conjunto de caracteres de execução)
/utf-8 (definir conjunto de caracteres de origem e execução como UTF-8)
/validate-charset (Validar se há caracteres compatíveis)