Compartilhar via


/validate-charset (Validar se os caracteres são compatíveis)

Essa opção do compilador valida se o texto do arquivo de origem contém apenas caracteres representáveis como UTF-8.

Sintaxe

validate-charset[-]

Comentários

Você pode usar a opção /validate-charset para validar se o código-fonte contém apenas caracteres que podem ser representados no conjunto de caracteres de origem e no conjunto de caracteres de execução. Essa verificação é habilitada automaticamente quando você especifica as opções do compilador /source-charset, /execution-charset ou /utf-8. Para desabilitar explicitamente essa verificação, especifique a opção /validate-charset-.

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 vai pressupor que o arquivo de origem está codificado na página de código do usuário atual, a menos que você tenha especificado uma página de código usando /utf-8 ou a opção /source-charset. 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. 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.

O Visual Studio usa UTF-8 como a codificação de caracteres interna durante a conversão entre o conjunto de caracteres de origem e o conjunto de caracteres de execução. Se um caractere do arquivo de origem não puder ser representado no conjunto de caracteres de execução, a conversão UTF-8 substituirá um caractere de ponto de interrogação (?). Se ocorrer uma substituição, a opção /validate-charset fará com que o compilador relate um aviso.

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 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 /validate-charset ou /validate-charset-.

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

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC
/execution-charset (Definir conjunto de caracteres de execução)
/source-charset (definir conjunto de caracteres de origem)
/utf-8 (definir conjunto de caracteres de origem e execução como UTF-8)