Tarea ClangCompile

Incluye la herramienta del compilador de Microsoft C++, clang.exe.

Parámetros

En la tabla siguiente se describen los parámetros de la tarea ClangCompile.

Parámetro Description
AdditionalIncludeDirectories Parámetro string[] opcional.

Especifica uno o más directorios que se agregarán a la ruta de acceso de inclusión; si hay más de uno, sepárelos mediante punto y coma.

Use -I[path].
AdditionalOptions Parámetro string opcional.
BufferSecurityCheck Parámetro string opcional.

La comprobación de seguridad ayuda a detectar desbordamientos del búfer de pila, un ataque común contra la seguridad de un programa.

Use fstack-protector.
BuildingInIde Parámetro bool opcional.
CLanguageStandard Parámetro string opcional.

Determina el estándar de lenguaje C.

Use std=[value] con el valor de c89, c99, c11, gnu99 o gnu11.
ClangVersion Parámetro string opcional.
CompileAs Parámetro string opcional.

Permite seleccionar la opción de lenguaje de compilación para los archivos .c y .cpp. El valor predeterminado detectará en función de .c o .cpp extensión.

Use -x c, -x c++.
CppLanguageStandard Parámetro string opcional.

Determina el estándar de lenguaje C++.

Use std=[value] con el valor de c++98, c++11, c++1y, gnu++98, gnu++11 o gnu++1y.
DataLevelLinking Parámetro bool opcional.

Permite que las optimizaciones del enlazador quiten datos no usados al emitir cada elemento de datos en una sección distinta.
DebugInformationFormat Parámetro string opcional.

Especifica el tipo de información de depuración generado por el compilador.

None, no produce información de depuración, por lo que la compilación puede ser más rápida (use g0).
FullDebug, genere información de depuración de DWARF2 (use g2 -gdwarf-2).
LineNumber, genere solo información del número de línea (use gline-tables-only).
EnableNeonCodegen Parámetro bool opcional.

Habilita la generación de código para hardware de punto flotante NEON. Esto solo es válido para la arquitectura ARM.
ExceptionHandling Parámetro string opcional.

Especifica el modelo de control de excepciones que usará el compilador.

Disabled, deshabilite el control de excepciones (use fno-exceptions).
Enabled, habilite el control de excepciones (use fexceptions).
UnwindTables, genera cualquier dato estático necesario, pero no afrcta al código generado(use funwind-tables).
FloatABI Parámetro string opcional.

Opción de selección para elegir ABI de punto flotante.

soft, hace que el compilador genere una salida que contiene llamadas de biblioteca para operaciones de punto flotante (use mfloat-abi=soft).
softfp, permite generar código con instrucciones de punto flotante de hardware, pero sigue usando las convenciones de llamadas flotantes de software (use mfloat-abi=softfp).
hard, permite generar instrucciones de punto flotante y usa convenciones de llamadas específicas de FPU (use mfloat-abi=hard).
ForcedIncludeFiles Parámetro string[] opcional.

Uno o más archivos de inclusión obligatorios.

Use -include [name].
FunctionLevelLinking Parámetro bool opcional.

Permite que el compilador empaquete las funciones individuales con formato de funciones empaquetadas (COMDATs). Es necesario para que funcione Editar y continuar.

Use ffunction-sections.
GccToolChain Parámetro string opcional.

Ruta de carpetas a la cadena de herramientas Gcc.
GNUMode Parámetro bool opcional.

MSCompatibility Parámetro bool opcional.

Habilitar la compatibilidad total con Microsoft C++.
MSCompatibilityVersion Parámetro string opcional.

Valor separado por puntos que representa el número de versión del compilador de Microsoft del que se informa en _MSC_VER (0 = no definirlo [valor predeterminado]).
MSExtensions Parámetro bool opcional.

Aceptar algunas construcciones no estándar que admita el compilador de Microsoft.
MSCompilerVersion Parámetro string opcional.

Número de versión del compilador de Microsoft del que se informa en _MSC_VER (0 = no definirlo [valor predeterminado]).
MSVCErrorReport Parámetro bool opcional.

Informar de los errores que pueda usar Visual Studio para realizar un análisis en busca de información de archivos y líneas.
ObjectFileName Parámetro string opcional.

Especifica un nombre para reemplazar el nombre del archivo objeto predeterminado. Puede ser un nombre de archivo o de directorio.

Use /Fo[name].
OmitFramePointers Parámetro bool opcional.

Suprime la creación de punteros de marcos en la pila de llamadas.
Optimización Parámetro string opcional.

Especifica el nivel de optimización de la aplicación.

Custom, optimización personalizada.
Disabled, deshabilite la optimización (use O0).
MinSize, optimice el tamaño (use Os).
MaxSpeed, optimice la velocidad (use O2).
Full, optimizaciones costosas (use O3).
PositionIndependentCode Parámetro bool opcional.

Genera código independiente de posición (PIC) para usarlo en una biblioteca compartida.
PrecompiledHeader Parámetro string opcional.

Habilita la creación o el uso de un encabezado precompilado durante la compilación.
PrecompiledHeaderFile Parámetro string opcional.

Especifica un nombre de archivo de encabezado que se va a usar para un archivo de encabezado precompilado. Este archivo también se agregará a Archivos de inclusión obligatorios durante la compilación.
PrecompiledHeaderOutputFileDirectory Parámetro string opcional.

Especifica el directorio del encabezado precompilado generado. Este directorio también se agregará a Directorios de inclusión adicionales durante la compilación.
PrecompiledHeaderCompileAs Parámetro string opcional.

Seleccione la opción de lenguaje de compilación para el archivo de encabezado precompilado.

Use -x c-header, -x c++-header.
PreprocessorDefinitions Parámetro string[] opcional.

Define un símbolo de preprocesamiento para el archivo de código fuente.

Use -D.
RuntimeLibrary Parámetro string opcional.

Especifique la biblioteca en tiempo de ejecución para la vinculación.

Use los conmutadores MSVC /MT, /MTd, /MD, /MDd.

MultiThreaded, hace que la aplicación use la versión estática multiproceso de la biblioteca en tiempo de ejecución.
MultiThreadedDebug, define _DEBUG y _MT. Esta opción también hace que el compilador coloque el nombre de la biblioteca LIBCMTD.lib en el archivo .obj, así el vinculador usará LIBCMTD.lib para resolver los símbolos externos.
MultiThreadedDLL, hace que la aplicación use la versión específica para multiproceso y la versión específica para DLL de la biblioteca en tiempo de ejecución. Define _MT y _DLL y hace que el compilador sitúe el nombre de la biblioteca MSVCRT.lib en el archivo .obj.
MultiThreadedDebugDLL, define _DEBUG, _MT y _DLL y hace que la aplicación use la versión de depuración multiproceso y específica para DLL de la biblioteca en tiempo de ejecución. También hace que el compilador coloque el nombre de la biblioteca MSVCRTD.lib en el archivo .obj.
RuntimeTypeInfo Parámetro bool opcional.

Agrega código para comprobar los tipos de objetos de C++ en tiempo de ejecución (información de tipo en tiempo de ejecución).

Use frtti, fno-rtti.
ShowIncludes Parámetro bool opcional.

Genera una lista de archivos de inclusión con los resultados del compilador.

Use -H.
Sources Parámetro obligatorio de tipo ITaskItem[] .
StrictAliasing Parámetro bool opcional.

Se da por supuesto que las reglas de alias son las más estrictas. Nunca se dará por supuesto que un objeto de un tipo se encuentra en la misma dirección que un objeto de un tipo distinto.
Sysroot Parámetro string opcional.

Ruta de carpetas al directorio raíz de encabezados y bibliotecas.
TargetArch Parámetro string opcional.

Arquitectura de destino.
ThumbMode Parámetro string opcional.

Cree código que se ejecuta para la microarquitectura Thumb. Esto solo es válido para la arquitectura ARM.

Thumb, genere código Thumb (use mthumb).
ARM, genere código Arm (use marm).
Disabled, opción no aplicable a la plataforma elegida.
TrackerLogDirectory Parámetro string opcional.

Directorio de registro de seguimiento.
TreatWarningAsError Parámetro bool opcional.

Trata todas las advertencias del compilador como errores.

Para un proyecto nuevo, puede ser mejor usar /WX en todas las compilaciones. Resolver todas las advertencias es una forma de asegurar el menor número posible de defectos de código difíciles de encontrar.
UndefinePreprocessorDefinitions Parámetro string[] opcional.

Especifica la anulación de una o varias definiciones del preprocesador.

Use -U [macro].
UndefineAllPreprocessorDefinitions Parámetro bool opcional.

Anula la definición de todos los valores del preprocesador definidos previamente.

Use -undef.
UseMultiToolTask Parámetro bool opcional.

Compilación multiprocesador.
UseShortEnums Parámetro bool opcional.

El tipo de enumeración usa solo los bytes que necesita el conjunto de entrada de valores posibles.
Detallado Parámetro bool opcional.

Muestra comandos para ejecutar y usar la salida detallada.
WarningLevel Parámetro string opcional.

Permite seleccionar cómo será de estricto el compilador en cuanto a los errores de código. Las otras marcas deben agregarse directamente a Opciones adicionales (consulte /w, /Weverything).

TurnOffAllWarnings, deshabilita todas las advertencias del compilador (use w).
EnableAllWarnings, habilita todas las advertencias, incluso las deshabilitadas de manera predeterminada (use Wall).

Vea también

Referencia de tareas