Partager via


Tâche ClangCompile

Remarque

Cette tâche est disponible uniquement lors de l’utilisation du système de génération C++.

Enveloppe l’outil de compilation C++ de Microsoft, clang.exe.

Paramètres

Le tableau ci-dessous décrit les paramètres de la tâche ClangCompile.

Paramètre Description
AdditionalIncludeDirectories Paramètre de chaîne[] facultatif.

Spécifie un ou plusieurs répertoires à ajouter au chemin include. Si vous ajoutez plusieurs répertoires, séparez-les par des points-virgules.

Utilisez -I[path].
AdditionalOptions Paramètre de chaîne facultatif.
BufferSecurityCheck Paramètre de chaîne facultatif.

La vérification de la sécurité permet de détecter les saturations de mémoire tampon de pile, une tentative courante d’attaque contre la sécurité d’un programme.

Utilisez fstack-protector.
BuildingInIDE Paramètre booléen facultatif.
CLanguageStandard Paramètre de chaîne facultatif.

Détermine la norme du langage C.

Utilisez std=[value] avec la valeur c89, c99, c11, gnu99 ou gnu11.
ClangVersion Paramètre de chaîne facultatif.
CompileAs Paramètre de chaîne facultatif.

Permet de sélectionner l’option de langage de compilation pour les fichiers .c et .cpp. La valeur par défaut détecte en fonction de l’extension .c ou .cpp.

Utilisez -x c, -x c++.
CppLanguageStandard Paramètre de chaîne facultatif.

Détermine la norme du langage C++.

Utilisez std=[value] avec la valeur c++98, c++11, c++1y, gnu++98, gnu++11 ou gnu++1y.
DataLevelLinking Paramètre booléen facultatif.

Permet aux optimisations de l’éditeur de liens de supprimer les données inutilisées en émettant chaque élément de données dans une section séparée.
DebugInformationFormat Paramètre de chaîne facultatif.

Indique le type d'informations de débogage générées par le compilateur.

Aucune, ne génère aucune information de débogage ; la compilation peut donc être plus rapide (utilisez g0).
FullDebug, générez des informations de débogage DWARF2 (utilisez g2 -gdwarf-2).
LineNumber, générez uniquement des informations de numéro de ligne (utilisez gline-tables-only).
EnableNeonCodegen Paramètre booléen facultatif.

Permet la génération de code pour le matériel NEON Floating Point. Applicable uniquement à l’architecture ARM.
ExceptionHandling Paramètre de chaîne facultatif.

Spécifie le modèle de gestion des exceptions à utiliser par le compilateur.

Désactivé, désactivez la gestion des exceptions (utilisez fno-exceptions).
Activé, activez la gestion des exceptions (utilisez fexceptions).
Tables Unwind, génère les données statiques requises, mais n’affecte pas le code généré (utilisez funwind-tables).
FloatABI Paramètre de chaîne facultatif.

Option pour choisir Floating Point ABI.

soft, le compilateur génère une sortie contenant des appels de bibliothèque pour les opérations à virgule flottante (utilisez mfloat-abi=soft).
softfp, autorise la génération de code avec des instructions à virgule flottante matérielle, mais utilise toujours les conventions d’appel soft-float (utilisez mfloat-abi=softfp).
hard, autorise la génération d’instructions à virgule flottante et utilise les conventions d’appel spécifiques FPU (utilisez mfloat-abi=hard).
ForcedIncludeFiles Paramètre de chaîne[] facultatif.

Un ou plusieurs fichiers Include forcés.

Utilisez -include [name].
FunctionLevelLinking Paramètre booléen facultatif.

Permet au compilateur d’empaqueter des fonctions individuelles sous la forme de fonctions empaquetées (COMDATs). Requis avec l’option Modifier et Continuer.

Utilisez ffunction-sections.
GccToolChain Paramètre de chaîne facultatif.

Chemin du dossier de la chaîne d’outils Gcc.
GNUMode Paramètre booléen facultatif.

MSCompatibility Paramètre booléen facultatif.

Activez la compatibilité complète de Microsoft C++.
MSCompatibilityVersion Paramètre de chaîne facultatif.

Valeur séparée par un point, qui représente le numéro de version du compilateur Microsoft à signaler dans _MSC_VER (0 = ne pas définir (valeur par défaut)).
MSExtensions Paramètre booléen facultatif.

Acceptez certaines constructions non standard prises en charge par le compilateur Microsoft.
MSCompilerVersion Paramètre de chaîne facultatif.

Numéro de version du compilateur Microsoft à signaler dans _MSC_VER (0 = ne pas définir (valeur par défaut)).
MSVCErrorReport Paramètre booléen facultatif.

Signalez les erreurs que Visual Studio peut utiliser pour analyser les informations de fichier et de ligne.
ObjectFileName Paramètre de chaîne facultatif.

Spécifie un nom de substitution pour le nom de fichier objet par défaut. Il peut s’agir d’un nom de fichier ou de répertoire.

Utilisez /Fo[name].
OmitFramePointers Paramètre booléen facultatif.

Empêche la création des pointeurs de frame sur la pile des appels.
Optimisation Paramètre de chaîne facultatif.

Indique le niveau d’optimisation pour l’application.

Personnalisé, optimisation personnalisée.
Désactivé, désactivez l’optimisation (utilisez O0).
MinSize, optimisez la taille (utilisez Os).
MaxSpeed, optimisez la vitesse (utilisez O2).
Complet, optimisations coûteuses (utilisez O3).
PositionIndependentCode Paramètre booléen facultatif.

Génère le code PIC (Position Independent Code) à utiliser dans une bibliothèque partagée.
PrecompiledHeader Paramètre de chaîne facultatif.

Active la création ou l’utilisation d’un en-tête précompilé pendant la génération.
PrecompiledHeaderFile Paramètre de chaîne facultatif.

Spécifie le nom du fichier d’en-tête à utiliser pour le fichier d’en-tête précompilé. Ce fichier est également ajouté aux Fichiers Include forcés pendant la génération.
PrecompiledHeaderOutputFileDirectory Paramètre de chaîne facultatif.

Spécifie le répertoire de l’en-tête précompilé généré. Ce répertoire est également ajouté aux Autres répertoires Include pendant la génération.
PrecompiledHeaderCompileAs Paramètre de chaîne facultatif.

Sélectionnez l’option de langage de compilation pour le fichier d’en-tête précompilé.

Utilisez -x c-header, -x c++-header.
PreprocessorDefinitions Paramètre de chaîne[] facultatif.

Définit des symboles de prétraitement pour votre fichier source.

Utilisez -D.
RuntimeLibrary Paramètre de chaîne facultatif.

Spécifiez la bibliothèque Runtime pour la liaison.

Utilisez les commutateurs MSVC /MT, /MTd, /MD, /MDd.

MultiThreaded, indique à votre application d’utiliser la version statique multithread de la bibliothèque Runtime.
MultiThreadedDebug, définit _DEBUG et _MT. Cette option indique également au compilateur d'ajouter le nom de bibliothèque LIBCMTD.lib dans le fichier .obj afin que l'Éditeur de liens utilise LIBCMTD.lib pour résoudre les symboles externes.
MultiThreadedDLL, indique à votre application d’utiliser la version spécifique au multithread et à la DLL de la bibliothèque Runtime. Définit _MT et _DLL, puis indique au compilateur de placer le nom de la bibliothèque MSVCRT.lib dans le fichier .obj.
MultiThreadedDebugDLL, définit _DEBUG, _MT et _DLL, puis indique à votre application d’utiliser la version spécifique au multithread et à la DLL de débogage de la bibliothèque Runtime. Le compilateur place également le nom de la bibliothèque MSVCRTD.lib dans le fichier .obj.
RuntimeTypeInfo Paramètre booléen facultatif.

Ajoute le code permettant de vérifier les types d’objet C++ à l’exécution (informations de type au moment de l’exécution).

Utilisez frtti, fno-rtti.
ShowIncludes Paramètre booléen facultatif.

Affiche la liste des fichiers include avec les résultats de la compilation.

Utilisez -H.
Sources Paramètre ITaskItem[] obligatoire.
StrictAliasing Paramètre booléen facultatif.

Les règles d’alias les plus strictes sont utilisées. Un objet d’un type donné n’est jamais considéré comme résidant à la même adresse qu’un objet d’un autre type.
Sysroot Paramètre de chaîne facultatif.

Chemin du dossier vers le répertoire racine pour les en-têtes et les bibliothèques.
TargetArch Paramètre de chaîne facultatif.

Architecture cible.
ThumbMode Paramètre de chaîne facultatif.

Générez du code qui s’exécute pour une microarchitecture Thumb. Applicable uniquement à l’architecture ARM.

Thumb, générez du code Thumb (utilisez mthumb).
ARM, générez du code Arm (utilisez marm).
Désactivé, option non applicable à la plateforme choisie.
TrackerLogDirectory Paramètre de chaîne facultatif.

Répertoire des journaux de suivi.
TreatWarningAsError Paramètre booléen facultatif.

Considère tous les avertissements du compilateur comme des erreurs.

Pour un nouveau projet, il est conseillé d’utiliser /WX dans toutes les compilations, car la résolution de tous les avertissements permet de réduire les erreurs de code difficilement détectables.
UndefinePreprocessorDefinitions Paramètre de chaîne[] facultatif.

Spécifie l’annulation de la définition d’une ou de plusieurs définitions du préprocesseur.

Utilisez -U [macro].
UndefineAllPreprocessorDefinitions Paramètre booléen facultatif.

Annule la définition de toutes les valeurs de préprocesseur précédemment définies.

Utilisez -undef.
UseMultiToolTask Paramètre booléen facultatif.

Compilation multiprocesseur.
UseShortEnums Paramètre booléen facultatif.

Un type enum utilise uniquement le nombre d’octets requis par l’ensemble des valeurs possibles d’entrée.
Verbose Paramètre booléen facultatif.

Affichez les commandes à exécuter et utilisez la sortie détaillée.
WarningLevel Paramètre de chaîne facultatif.

Sélectionnez la rigueur avec laquelle le compilateur doit traiter les erreurs de code. D’autres indicateurs doivent être ajoutés directement dans les Options supplémentaires (voir /w, /Weverything).

TurnOffAllWarnings, désactive tous les avertissements du compilateur (utilisez w).
EnableAllWarnings, active tous les avertissements, dont ceux qui sont désactivés par défaut (utilisez Wall).

Voir aussi

Informations de référence sur les tâches