Compartilhar via


/execution-charset (Definir conjunto de caracteres de execução)

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

Sintaxe

/execution-charset:[IANA_name | .CPID]

Argumentos

IANA_name
O nome do conjunto de caracteres definido pela IANA.

.CPID
O identificador de página de código, precedido por um caractere ..

Comentários

Você pode usar a opção /execution-charset para especificar um conjunto de caracteres de execução. O conjunto de caracteres de execução é a codificação usada para o texto do programa que é inserido na fase de compilação após todas as etapas de pré-processamento. Esse conjunto de caracteres é usado para a representação interna de qualquer cadeia de caracteres ou literais de caracteres no código compilado. Defina essa opção para especificar o conjunto de caracteres de execução estendido a ser usado quando os arquivos de origem incluírem caracteres que não são representáveis no conjunto de caracteres de execução básico. 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ê tenha usado 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 informações sobre conjuntos de caracteres de origem e execução, confira Conjuntos de caracteres na documentação da linguagem.

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 mais informações, 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 /execution-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 da linha de comando do compilador MSVC
/source-charset (definir conjunto de caracteres de origem)
/utf-8 (definir conjunto de caracteres de origem e execução como UTF-8)
/validate-charset (Validar se há caracteres compatíveis)