Compartir a través de

/source-charset (Establecer juego de caracteres de origen)

  • Artículo

Esta opción permite especificar el juego de caracteres de origen del archivo ejecutable.

Sintaxis

/source-charset:[IANA_name | .CPID]

Argumentos

IANA_name
Nombre del juego de caracteres definido por IANA.

.CPID
Identificador de página de códigos como número decimal, precedido por un carácter ..

Comentarios

Puede usar la opción /source-charset para especificar un juego de caracteres de origen extendido que se usará cuando los archivos de origen incluyan caracteres que no están representados en el juego de caracteres de origen básico. El juego de caracteres de origen es la codificación utilizada para interpretar el texto de origen del programa. Se convierte en la representación interna que se usa como entrada en las fases de preprocesamiento antes de la compilación. Después, la representación interna se convierte en el juego de caracteres de ejecución para almacenar valores de cadena y carácter en el ejecutable. Puede usar el nombre del juego de caracteres IANA o ISO, o un punto (.) seguido de 3 a 5 dígitos decimales que especifican el identificador de página de códigos del juego de caracteres que se va a usar. Para obtener una lista de los identificadores de página de códigos y los nombres de juegos de caracteres admitidos, consulte Identificadores de página de códigos.

De forma predeterminada, Visual Studio detecta una marca BOM para determinar si el archivo de código fuente está en un formato Unicode codificado, por ejemplo, UTF-16 o UTF-8. Si no se encuentra ninguna marca de orden de bytes, se supone que el archivo de origen está codificado en la página de códigos del usuario actual, a menos que use la opción /source-charset o /utf-8 para especificar un nombre de juego de caracteres o una página de códigos. Visual Studio permite guardar el código fuente de C++ en diversas codificaciones de caracteres. Para más información sobre los juegos de caracteres de origen y ejecución, consulte Juegos de caracteres en la documentación del lenguaje.

El juego de caracteres de origen que proporcione debe asignar los caracteres ASCII de 7 bits a los mismos puntos de código del juego de caracteres, o es probable que sigan muchos errores de compilación. El juego de caracteres de origen también debe tener una asignación al juego de caracteres Unicode extendido de UTF-8. Los caracteres que no tienen ningún equivalente en UTF-8 se representan mediante un sustituto específico de la implementación. El compilador de Microsoft usa un signo de interrogación para estos caracteres.

Si quiere establecer el juego de caracteres de origen y el juego de caracteres de ejecución en UTF-8, puede usar la opción del compilador /utf-8 como método abreviado. Es equivalente a /source-charset:utf-8 /execution-charset:utf-8 en la línea de comandos. Cualquiera de estas opciones también habilita la opción /validate-charset de forma predeterminada.

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>C/C++>Línea de comandos.

  3. En Opciones adicionales, agregue la opción /source-charset y especifique la codificación preferida.

  4. Elija Aceptar para guardar los cambios.

Consulte también

Opciones del compilador de MSVC
Sintaxis de línea de comandos del compilador de MSVC
/execution-charset (Establecer el juego de caracteres de ejecución)
/utf-8 (Establecer juegos de caracteres de origen y ejecución en UTF-8)
/validate-charset (Validar caracteres compatibles)