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

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 IANA ou ISO, ou un point (.) suivi de 3 à 5 chiffres 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 une marque d’ordre d’octet pour déterminer si le fichier source est au format Unicode encodé, par exemple UTF-16 ou UTF-8. 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 encodages de caractères. 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 du /utf-8 compilateur comme raccourci. Il est équivalent à /source-charset:utf-8 /execution-charset:utf-8 celui de la ligne de commande. L’une de ces options active é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 de votre 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 votre encodage préféré.

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 des jeux de caractères source et d’exécution sur UTF-8)
/validate-charset (Valider pour les caractères compatibles)