CL (tarea)

  • Artículo

Nota:

Esta tarea solo está disponible cuando se usa el sistema de compilación de C++.

Incluye la herramienta del compilador de Microsoft C++, cl.exe. El compilador genera archivos ejecutables ( .exe), archivos de biblioteca de vínculos dinámicos ( .dll) o archivos de módulos de códigos ( .netmodule). Para obtener más información, consulte los artículos Opciones del compilador, MSBuild en la línea de comandos y Uso del conjunto de herramientas de Microsoft C++ desde la línea de comandos.

Parámetros

En la siguiente lista se describen los parámetros de la tarea CL. La mayoría de los parámetros de tarea, así como algunos conjuntos de parámetros, corresponden a una opción de línea de comandos.

  • AdditionalIncludeDirectories

    Parámetro String[] opcional.

    Agrega un directorio a la lista de directorios en que se buscan archivos de inclusión.

    Para obtener más información, vea /I (Directorios de inclusión adicionales).

  • AdditionalOptions

    Parámetro String opcional.

    Una lista de opciones de la línea de comandos. Por ejemplo, "/<opción1> /<opción2> /<opción#>". Utilice este parámetro para especificar opciones de la línea de comandos que no están representadas por ningún otro parámetro de tarea.

    Para obtener más información, vea Opciones del compilador.

  • AdditionalUsingDirectories

    Parámetro String[] opcional.

    Especifica un directorio en que el compilador debe buscar para resolver las referencias de archivos que se pasan a la directiva #using.

    Para obtener más información, vea /AI (Especificar directorios de metadatos).

  • AlwaysAppend

    Parámetro String opcional.

    Una cadena que siempre se emite en la línea de comandos. Su valor predeterminado es " /c".

  • AssemblerListingLocation

    Crea un archivo de lista que contiene el código de ensamblado.

    Para obtener más información, vea la opción /Fa en /FA, /Fa (Archivo de lista).

  • AssemblerOutput

    Parámetro String opcional.

    Crea un archivo de lista que contiene el código de ensamblado.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

    • NoListing - <none>

    • AssemblyCode - /FA

    • AssemblyAndMachineCode - /FAc

    • AssemblyAndMachineCode - /FAc

    • All - /FAcs

      Para obtener más información, vea las opciones /FA, /FAc, /FAs y /FAcs en /FA, /Fa (Archivo de lista).

  • BasicRuntimeChecks

    Parámetro String opcional.

    Activa y desactiva la característica de comprobación de errores en tiempo de ejecución, junto con el pragma runtime_checks.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • BrowseInformation

    Parámetro booleano opcional.

    Si true, crea un archivo de información de examen.

    Para obtener más información, vea la opción /FR en /FR, /Fr (Crear archivo .Sbr).

  • BrowseInformationFile

    Parámetro String opcional.

    Especifica un nombre de archivo para el archivo de información de examen.

    Para obtener más información, vea el parámetro BrowseInformation en esta tabla y también /FR, /Fr (Crear archivo .Sbr).

  • BufferSecurityCheck

    Parámetro booleano opcional.

    Si true, detecta algunas saturaciones de búfer que sobrescriben la dirección de retorno, una técnica común para aprovechar código que no impone restricciones de tamaño de búfer.

    Para obtener más información, vea /GS (Comprobación de seguridad del búfer).

  • BuildingInIDE

    Parámetro booleano opcional.

    Si true, indica que el IDE invoca MSBuild. De lo contrario, MSBuild se invoca en la línea de comandos.

  • CallingConvention

    Parámetro String opcional.

    Especifica la convención de llamada, que determina el orden en que los argumentos de función se insertan en la pila, si la función de llamador o de llamada quita los argumentos de la pila al final de la llamada y la convención de decoración de nombres que el compilador utiliza para identificar funciones individuales.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • CompileAs

    Parámetro String opcional.

    Especifica si se debe compilar el archivo de entrada como un archivo de código fuente de C o C++.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • CompileAsManaged

    Parámetro String opcional.

    Permite que las aplicaciones y los componentes usen las características de Common Language Runtime (CLR).

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • CreateHotpatchableImage

    Parámetro booleano opcional.

    Si true, indica al compilador que prepare una imagen para aplicar una revisión reciente. Este parámetro garantiza que la primera instrucción de cada función sea de dos bytes, lo cual es necesario para aplicar una revisión reciente.

    Para obtener más información, vea /hotpatch (Crear una imagen a la que se puede aplicar una revisión reciente).

  • DebugInformationFormat

    Parámetro String opcional.

    Selecciona el tipo de información de depuración que se crea para el programa y si esta información se conserva en archivos de objeto ( .obj) o en una base de datos de programa (PDB).

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • DisableLanguageExtensions

    Parámetro booleano opcional.

    Si true, indica al compilador que emita un error para las construcciones de lenguaje que no son compatibles con ANSI C o ANSI C++.

    Para obtener más información, vea la opción /Za en /Za, /Ze (Deshabilitar extensiones de lenguaje).

  • DisableSpecificWarnings

    Parámetro String[] opcional.

    Desactiva los números de advertencia que se especifican en una lista delimitada por punto y coma.

    Para obtener más información, vea la opción /wd en /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nivel de advertencia).

  • EnableEnhancedInstructionSet

    Parámetro String opcional.

    Especifica la arquitectura para la generación de código que usa las instrucciones De extensiones SIMD de streaming (SSE), Extensiones SIMD de streaming 2 (SSE2) y Extensiones vectoriales avanzadas (AVX).

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

    • NoExtensions - /arch:IA32

    • StreamingSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2

    • AdvancedVectorExtensions - /arch:AVX

    • AdvancedVectorExtensions2 - /arch:AVX2

    • AdvancedVectorExtensions512 - /arch:AVX512

      Para obtener más información, consulte /arch (x86).

  • EnableFiberSafeOptimizations

    Parámetro booleano opcional.

    Si true, admite la seguridad de fibras para los datos asignados mediante almacenamiento local de subprocesos estáticos, es decir, los datos asignados mediante __declspec(thread).

    Para obtener más información, vea /GT (Admitir el almacenamiento local de subprocesos para fibra).

  • EnablePREfast

    Parámetro booleano opcional.

    Si true, habilita el análisis de código.

    Para obtener más información, vea /analyze (Análisis de código).

  • ErrorReporting

    Parámetro String opcional.

    Permite proporcionar directamente a Microsoft información sobre los errores internos del compilador (ICE). De forma predeterminada, la configuración de compilaciones del IDE es Prompt y la configuración en las compilaciones de la línea de comandos es Queue.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • ExceptionHandling

    Parámetro String opcional.

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

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • ExpandAttributedSource

    Parámetro booleano opcional.

    Si true, crea un archivo de lista con los atributos expandidos insertados en el archivo origen.

    Para obtener más información, vea /Fx (Combinar código insertado).

  • FavorSizeOrSpeed

    Parámetro String opcional.

    Especifica si se va a favorecer el tamaño o la velocidad del código.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • FloatingPointExceptions

    Parámetro booleano opcional.

    Si true, activa el modelo confiable de excepción de punto flotante. Las excepciones se generarán inmediatamente después de desencadenarse.

    Para obtener más información, vea la opción fp:except en /fp (Especificar comportamiento de punto flotante).

  • FloatingPointModel

    Parámetro String opcional.

    Establece el modelo de punto flotante.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • ForceConformanceInForLoopScope

    Parámetro booleano opcional.

    Si true, implementa el comportamiento estándar de C++ en los bucles for que utilizan las extensiones de Microsoft (/Ze).

    Para obtener más información, vea /Zc:forScope (Forzar ajuste en el ámbito del bucle For).

  • ForcedIncludeFiles

    Parámetro String[] opcional.

    Hace que el preprocesador procese uno o varios archivos de encabezado especificados.

    Para obtener más información, vea /FI (Dar nombre al archivo de inclusión obligatorio).

  • ForcedUsingFiles

    Parámetro String[] opcional.

    Hace que el preprocesador procese uno o varios archivos #using especificados.

    Para obtener más información, vea /FU (Asignar nombre al archivo #using obligatorio).

  • FunctionLevelLinking

    Parámetro Boolean opcional.

    Si true, permite que el compilador empaquete las funciones individuales con formato de funciones empaquetadas (COMDATs).

    Para obtener más información, vea /Gy (Habilitar vinculación en el nivel de función).

  • GenerateXMLDocumentationFiles

    Parámetro Boolean opcional.

    Si es true, hace que el compilador procese los comentarios de documentación en archivos de código fuente y cree un archivo .xdc para cada archivo de código fuente que tenga comentarios de documentación.

    Para obtener más información, vea /doc (Procesar comentarios de documentación) (C/C++). Consulte también el parámetro XMLDocumentationFileName en esta tabla.

  • IgnoreStandardIncludePath

    Parámetro Boolean opcional.

    Si true, impide que el compilador busque archivos de inclusión en los directorios especificados en las variables de entorno PATH e INCLUDE.

    Para obtener más información, vea /X (Omitir rutas de acceso de inclusión estándar).

  • InlineFunctionExpansion

    Parámetro String opcional.

    Especifica el nivel de expansión de funciones insertadas para la compilación.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • IntrinsicFunctions

    Parámetro Boolean opcional.

    Si true, reemplaza algunas llamadas a función con formas intrínsecas o especiales de la función que ayudarán a que la aplicación se ejecute con mayor rapidez.

    Para obtener más información, vea /Oi (Generar funciones intrínsecas).

  • MinimalRebuild

    Parámetro Boolean opcional. Esta opción está en desuso.

    Si true, habilita la recompilación mínima, que determina si es necesario recompilar los archivos de origen de C++ que incluyen definiciones de clases de C++ cambiadas (almacenadas en archivos de encabezado [.h]).

    Para obtener más información, vea /Gm (Habilitar recompilación mínima).

  • MultiProcessorCompilation

    Parámetro Boolean opcional.

    Si true, utilice varios procesadores para compilar. Este parámetro crea un proceso para cada procesador efectivo en su equipo.

    Para obtener más información, vea /MP (Compilar con varios procesos). Consulte también el parámetro ProcessorNumber en esta tabla.

  • ObjectFileName

    Parámetro String opcional.

    Especifica un nombre de archivo objeto (.obj) o un directorio que se utilizará en lugar del predeterminado.

    Para obtener más información, vea /Fo (Nombre del archivo objeto).

  • ObjectFiles

    Parámetro String[] opcional.

    Una lista de los archivos objeto.

  • OmitDefaultLibName

    Parámetro Boolean opcional.

    Si es true, omite el nombre predeterminado de la biblioteca en tiempo de ejecución de C del archivo objeto ( .obj). De forma predeterminada, el compilador coloca el nombre de la biblioteca en el archivo .obj para dirigir el enlazador a la biblioteca correcta.

    Para obtener más información, vea /Zl (Omitir nombres de biblioteca predeterminada).

  • OmitFramePointers

    Parámetro Boolean opcional.

    Si true, suprime la creación de punteros de marcos en la pila de llamadas.

    Para obtener más información, vea /Oy (Omisión de puntero de marco).

  • OpenMPSupport

    Parámetro Boolean opcional.

    Si true, hace que el compilador procese cláusulas y directivas de OpenMP.

    Para obtener más información, vea /openmp (Habilitar la compatibilidad con OpenMP 2.0).

  • Optimization

    Parámetro String opcional.

    Especifica diversas optimizaciones de código para la velocidad y el tamaño.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • PrecompiledHeader

    Parámetro String opcional.

    Cree o use un archivo de encabezado precompilado ( .pch) durante la compilación.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • PrecompiledHeaderFile

    Parámetro String opcional.

    Especifica un nombre de archivo de encabezado precompilado para crear o utilizar.

    Para obtener más información, vea //Yc (Crear archivo de encabezado precompilado) y /Yu (Utilizar el archivo de encabezado precompilado).

  • PrecompiledHeaderOutputFile

    Parámetro String opcional.

    Especifica un nombre de ruta de acceso a un encabezado precompilado en lugar de utilizar el nombre de ruta de acceso predeterminado.

    Para obtener más información, vea /Fp (Dar nombre al archivo .Pch).

  • PreprocessKeepComments

    Parámetro Boolean opcional.

    Si true, conserva los comentarios durante el preprocesamiento.

    Para obtener más información, vea /C (Conservar los comentarios durante el preprocesamiento).

  • PreprocessorDefinitions

    Parámetro String[] opcional.

    Define un símbolo de preprocesamiento para el archivo de origen.

    Para obtener más información, vea /D (Definiciones de preprocesador).

  • PreprocessOutput

    Parámetro ITaskItem[] opcional.

    Define una matriz de elementos de elementos de salida del preprocesador que las tareas pueden consumir y emitir.

  • PreprocessOutputPath

    Parámetro String opcional.

    Especifica el nombre del archivo de salida en el que el parámetro PreprocessToFile escribe la salida preprocesada.

    Para obtener más información, vea /Fi (Preprocesar el nombre del archivo de salida).

  • PreprocessSuppressLineNumbers

    Parámetro Boolean opcional.

    Si true, preprocesa archivos de origen de C y C++ y copia los archivos preprocesados en el dispositivo de salida estándar.

    Para obtener más información, vea /EP (Preprocesar para stdout sin directivas #line).

  • PreprocessToFile

    Parámetro Boolean opcional.

    Si true, preprocesa archivos de origen de C y C++ y escribe la salida preprocesada en un archivo.

    Para obtener más información, vea /P (Preprocesar y escribir en un archivo).

  • ProcessorNumber

    Parámetro Integer opcional.

    Especifica el número máximo de procesadores que se utilizan en una compilación con varios procesadores. Utilice este parámetro en combinación con el parámetro MultiProcessorCompilation.

  • ProgramDataBaseFileName

    Parámetro String opcional.

    Especifica un nombre de archivo para el archivo de base de datos del programa (PDB).

    Para obtener más información, vea /Fd (Nombre del archivo de base de datos del programa).

  • RuntimeLibrary

    Parámetro String opcional.

    Indica si un módulo multiproceso es un archivo DLL y selecciona versiones comerciales o de depuración de la biblioteca en tiempo de ejecución.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • RuntimeTypeInfo

    Parámetro Boolean opcional.

    Si true, 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).

    Para obtener más información, vea /GR (Habilitar la información de tipo en tiempo de ejecución).

  • ShowIncludes

    Parámetro Boolean opcional.

    Si true, hace que el compilador genere una lista de los archivos de inclusión.

    Para obtener más información, vea /showIncludes (Enumerar archivos de inclusión).

  • SmallerTypeCheck

    Parámetro Boolean opcional.

    Si true, informa de un error de tiempo de ejecución si un valor se asigna a un tipo de datos más pequeño y produce una pérdida de datos.

    Para obtener más información, vea la opción /RTCc en /RTC (Comprobaciones de errores en tiempo de ejecución).

  • Sources

    Parámetro ITaskItem[] requerido.

    Especifica una lista de archivos de código fuente, separados por espacios.

  • StringPooling

    Parámetro Boolean opcional.

    Si true, permite al compilador crear una copia de cadenas idénticas en la imagen del programa.

    Para obtener más información, vea /GF (Eliminar cadenas duplicadas).

  • StructMemberAlignment

    Parámetro String opcional.

    Especifica la alineación de bytes para todos los miembros de una estructura.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • SuppressStartupBanner

    Parámetro Boolean opcional.

    Si es true, evita que se muestre el copyright y el mensaje de número de versión cuando la tarea se inicia.

    Para obtener más información, vea /NOLOGO (Suprimir el titular de inicio) (C/C++).

  • TrackerLogDirectory

    Parámetro String opcional.

    Especifica el directorio intermedio en que se almacenan los registros de seguimiento para esta tarea.

    Para obtener más información, consulte los parámetros TLogReadFiles y TLogWriteFiles en esta tabla.

  • TreatSpecificWarningsAsErrors

    Parámetro String[] opcional.

    Trata la lista especificada de advertencias del compilador como errores.

    Para obtener más información, vea la opción /wen en /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nivel de advertencia).

  • TreatWarningAsError

    Parámetro Boolean opcional.

    Si true, trata todas las advertencias del compilador como errores.

    Para obtener más información, vea la opción /WX en /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Nivel de advertencia).

  • TreatWChar_tAsBuiltInType

    Parámetro Boolean opcional.

    Si true, trate el tipo wchar_t como un tipo nativo.

    Para obtener más información, vea /Zc:wchar_t (wchar_t es un tipo nativo).

  • UndefineAllPreprocessorDefinitions

    Parámetro Boolean opcional.

    Si true, anula la definición de los símbolos específicos de Microsoft que el compilador define.

    Para obtener más información, vea la opción /u en /U, /u (Anular la definición de símbolos).

  • UndefinePreprocessorDefinitions

    Parámetro String[] opcional.

    Especifica una lista de uno o más símbolos de preprocesador para anular la definición.

    Para obtener más información, vea la opción /U en /U, /u (Anular la definición de símbolos).

  • UseFullPaths

    Parámetro Boolean opcional.

    Si true, muestra la ruta de acceso completa de archivos de código fuente pasados al compilador en diagnósticos.

    Para obtener más información, vea /FC (Ruta de acceso completa de archivo de código fuente en diagnósticos).

  • UseUnicodeForAssemblerListing

    Parámetro Boolean opcional.

    Si true, hace que el archivo de salida se cree en formato UTF-8.

    Para obtener más información, vea la opción /FAu en /FA, /Fa (Archivo de lista).

  • WarningLevel

    Parámetro String opcional.

    Especifica el nivel de advertencia máximo que el compilador generará.

    Especifique uno de los valores siguientes, cada uno de los cuales corresponde a una opción de línea de comandos.

  • WholeProgramOptimization

    Parámetro Boolean opcional.

    Si true, habilita la optimización de todo el programa.

    Para obtener más información, vea /GL (Optimización de todo el programa).

  • XMLDocumentationFileName

    Parámetro String opcional.

    Especifica el nombre de los archivos de documentación XML generados. Este parámetro puede ser un nombre de archivo o directorio.

    Para obtener más información, vea el argumento name en /doc (Procesar comentarios de documentación) (C/C++). Consulte también el parámetro GenerateXMLDocumentationFiles en esta tabla.

  • MinimalRebuildFromTracking

    Parámetro Boolean opcional.

    Si true, se realiza una compilación incremental con seguimiento; si false, se realiza una recompilación.

  • TLogReadFiles

    Parámetro ITaskItem[] opcional.

    Especifica una matriz de elementos que representan los registros de seguimiento de archivos de lectura.

    Un registro de seguimiento de archivos de lectura ( .tlog) contiene los nombres de los archivos de entrada que una tarea lee, y el sistema de compilación de proyecto lo usa para admitir las compilaciones incrementales. Para obtener más información, consulte los parámetros TrackerLogDirectory y TrackFileAccess en esta tabla.

  • TLogWriteFiles

    Parámetro ITaskItem[] opcional.

    Especifica una matriz de elementos que representan los registros de seguimiento de archivos de escritura.

    Un registro de seguimiento de archivos de escritura ( .tlog) contiene los nombres de los archivos de salida que una tarea escribe, y el sistema de compilación de proyecto lo usa para admitir las compilaciones incrementales. Para obtener más información, consulte los parámetros TrackerLogDirectory y TrackFileAccess en esta tabla.

  • TrackFileAccess

    Parámetro Boolean opcional.

    Si true, realiza un seguimiento de los patrones de acceso a archivos.

    Para obtener más información, consulte los parámetros TLogReadFiles y TLogWriteFiles en esta tabla.

Vea también