Partager via

/source-charset (Définir le jeu de caractères source)

  • Article

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

Syntaxe

/source-charset:[IANA_name | .CPID]

Arguments

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

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

Notes

Vous pouvez utiliser l’option /source-charset pour spécifier un jeu de caractères source étendu à utiliser lorsque vos fichiers sources incluent des caractères qui ne sont pas représentés dans le jeu de caractères source de base. Le jeu de caractères source est l’encodage utilisé pour interpréter le texte source de votre programme. Elle est convertie en représentation interne utilisée comme entrée dans les phases de prétraitement avant la compilation. La représentation interne est ensuite convertie en jeu de caractères d’exécution pour stocker des valeurs de chaîne et de caractères dans l’exécutable. 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 aucune marque d’ordre d’octet n’est trouvée, il suppose que le fichier source est encodé dans la page de codes utilisateur actuelle, sauf si vous utilisez la ou /utf-8 l’option /source-charset 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 les jeux de caractères dans la documentation de langue.

Le jeu de caractères source que vous fournissez doit mapper les caractères ASCII 7 bits aux mêmes points de code dans votre jeu de caractères, ou de nombreuses erreurs de compilation sont susceptibles de suivre. Votre jeu de caractères source doit également avoir un mappage au jeu de caractères Unicode étendu de UTF-8. Les caractères qui n’ont pas d’équivalent en UTF-8 sont représentés par un substitut spécifique à l’implémentation. Le compilateur Microsoft utilise un point d’interrogation pour ces caractères.

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 /source-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
/execution-charset (Définir le jeu de caractères d’exécution)
/utf-8 (Définir les jeux de caractères source et d’exécution sur UTF-8)
/validate-charset (Valider les caractères compatibles)