Partager via

/execution-charset (Définir le jeu de caractères d’exécution)

  • Article

Cette option vous permet de spécifier le jeu de caractères d’exécution de votre exécutable.

Syntaxe

/execution-charset:[IANA_name | .CPID]

Arguments

IANA_name
Nom du jeu de caractères défini par l’IANA.

.CPID
Identificateur de page de codes, précédé d’un caractère ..

Notes

Vous pouvez utiliser l’option /execution-charset pour spécifier un jeu de caractères d’exécution. Le jeu de caractères d’exécution désigne le codage utilisé pour le texte de votre programme saisi durant la phase de compilation et à l’issue de l’ensemble des étapes de prétraitement. Ce jeu de caractères est utilisé pour la représentation interne de n’importe quel littéral de chaîne ou de caractères dans le code compilé. Définissez cette option pour spécifier le jeu de caractères d’exécution étendu à utiliser lorsque vos fichiers sources incluent des caractères non représentés dans le jeu de caractères d’exécution de base. Vous pouvez utiliser le nom du jeu de caractères aux formats IANA ou ISO, ou un point (.) suivi de trois à cinq nombres décimaux qui spécifient l’identificateur de page de codes du jeu de caractères à utiliser. Pour obtenir la liste des identificateurs de page de codes pris en charge et des noms de jeu de caractères, consultez Identificateurs de page de codes.

Par défaut, Visual Studio détecte un indicateur d'ordre des octets pour déterminer si le fichier source est au format Unicode encodé (UTF-16 ou UTF-8, par exemple). Si aucun indicateur d'ordre des octets n’est identifié, Visual Studio considère que le fichier source est encodé dans la page de codes utilisateur actuelle, sauf si vous avez utilisé l’option /source-charset ou l’option /utf-8 pour spécifier un nom ou une page de codes de jeu de caractères. Visual Studio vous permet d’enregistrer votre code source C++ dans l’un des codages de caractères disponibles. Pour plus d’informations sur les jeux de caractères source et d’exécution, consultez Jeux de caractères dans la documentation linguistique.

Si vous souhaitez définir à la fois le jeu de caractères source et le jeu de caractères d’exécution sur UTF-8, vous pouvez utiliser l’option de compilateur /utf-8 en tant que raccourci. Cette option correspond à /source-charset:utf-8 /execution-charset:utf-8 en ligne de commande. Ces deux options activent également l’option /validate-charset par défaut.

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriétés du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Ligne de commande.

  3. Dans Options supplémentaires, ajoutez l’option /execution-charset et spécifiez le codage de votre choix.

  4. Sélectionnez OK pour enregistrer vos modifications.

Voir aussi

Options du compilateur MSVC
Syntaxe de ligne de commande du compilateur MSVC
/source-charset (Définir le jeu de caractères source)
/utf-8 (Définir les jeux de caractères source et d’exécution sur UTF-8)
/validate-charset (Valider les caractères compatibles)