/FA, /Fa (Archivo de listas)

  • Artículo

Crea un archivo de listas que contiene el código del ensamblador.

Sintaxis

/FA[c][s][u]
/Fapathname

Comentarios

La opción del compilador /FA genera un archivo de listas de ensamblado para cada unidad de traducción de la compilación, que normalmente corresponde a un archivo de código fuente de C o C++. De manera predeterminada, solo el ensamblador se incluye en el archivo de listas que se codifica como ANSI. Los argumentos opcionales c, s y u para /FA controlar si el código de máquina o el código fuente se generan junto con la lista del ensamblador y si la lista está codificada como UTF-8.

De manera predeterminada, cada archivo de listas obtiene el mismo nombre base que el archivo de origen y tiene una extensión .asm. Cuando el código de máquina se incluye mediante la opción c, el archivo de listas tiene una extensión .cod. Puede cambiar el nombre, la extensión del archivo de listas y el directorio donde se crea mediante la opción /Fa.

Argumentos de /FA

None
En la lista solo se incluye el lenguaje de ensamblador.

c
Opcional. Incluye el código de máquina en la lista.

s
Opcional. Incluye el código fuente en la lista.

u
Opcional. Codifica el archivo de listas en formato UTF-8 e incluye un marcador de orden de byte. De manera predeterminada, el archivo se codifica como ANSI. Use u para crear un archivo de listas que se muestre correctamente en cualquier sistema o si usa archivos de código fuente Unicode como entrada al compilador.

Si se especifican s y u, y si un archivo de código fuente usa una codificación Unicode que no sea UTF-8, es posible que las líneas de código del archivo .asm no se muestren correctamente.

Argumento /Fa

None
Se crea un archivo source.asm para cada archivo de código fuente en la compilación.

filename
El compilador coloca un archivo de listas denominado filename.asm en el directorio actual. Este formato de argumento solo es válido al compilar un único archivo de código fuente.

filename.extension
El compilador coloca un archivo de listas denominado filename.extension en el directorio actual. Este formato de argumento solo es válido al compilar un único archivo de código fuente.

directorio\
El compilador crea un archivo source_file.asm para cada archivo de código fuente en la compilación. Se coloca en el directorio especificado. La barra diagonal inversa final es necesaria. Solo se permiten las rutas de acceso en el disco actual.

directory\filename
Un archivo de listas denominado filename.asm se coloca en el directorio especificado. Este formato de argumento solo es válido al compilar un único archivo de código fuente.

directory\filename.extension
Un archivo de listas denominado filename.extension se coloca en el directorio especificado. Este formato de argumento solo es válido al compilar un único archivo de código fuente.

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>C/C++>Archivos de salida.

  3. Modifique la propiedad Resultados del ensamblador para establecer las opciones /FAc y /FAs para el ensamblador, la máquina y el código fuente. Modifique la propiedad Usar Unicode para la lista de ensambladores para establecer la opción /FAu de salida ANSI o UTF-8. Modifique la ubicación de la lista de ASM para establecer la opción /Fa nombre de archivo de listas y la ubicación.

Establecer las propiedades Salida del ensamblador y Usar Unicode para la lista de ensambladores puede provocar La advertencia de la línea de comandos D9025. Para combinar estas opciones en el IDE, use en su lugar el campo Opciones adicionales en la página de propiedades de la Línea de comandos.

Para establecer esta opción del compilador mediante programación

Ejemplo

La siguiente línea de comandos genera una lista combinada de código fuente y de código máquina denominada HELLO.cod:

CL /FAcs HELLO.CPP

Consulte también

/F (Opciones del archivo de resultados)
Opciones del compilador de MSVC
Sintaxis de la línea de comandos del compilador MSVC
Especificar la ruta de acceso