/FA/Fa(列表文件)

创建包含汇编程序代码的列表文件。

语法


/Fapathname

备注

/FA 编译器选项为编译中的每个转换单元生成一个汇编程序列表文件,该文件通常对应于 C 或 C++ 源文件。 默认情况下,此列表文件中仅包含编码为 ANSI 的汇编程序。 /FAcsu 可选参数可控制计算机代码或源代码是否与汇编程序列表一起输出以及列表是否编码为 UTF-8。

默认情况下,每个列表文件获取与源文件相同的基名称,并且具有 .asm 扩展名。 使用 c 选项包括计算机代码时,列表文件将具有 .cod 扩展名。 可以使用 /Fa 选项更改此列表文件的名称和扩展名以及创建目录。

/FA 参数


仅将汇编程序语言包括在此列表中。

c
可选。 将计算机代码包括在此列表中。

s
可选。 将源代码包括在此列表中。

u
可选。 以 UTF-8 格式对列表文件进行编码,并包括字节顺序标记。 默认情况下,该文件编码为 ANSI。 使用 u 创建可在任何系统上正确显示的列表文件,或者使用 Unicode 源代码文件作为编译器的输入。

如果同时指定 su,并且源代码文件使用 UTF-8 以外的 Unicode 编码,则 .asm 文件中的代码行可能无法正确显示。

/Fa 参数


为编译中的每个源代码文件创建一个 source.asm 文件。

filename
编译器将名为 filename.asm 的列表文件置于当前目录中。 此参数形式仅在编译单个源代码文件时才有效。

filename.extension
编译器将名为 filename.extension 的列表文件置于当前目录中。 此参数形式仅在编译单个源代码文件时才有效。

目录\
编译器为编译中的每个源代码文件创建一个 source_file.asm 文件。 将其置于指定的目录中。 尾部反斜杠是必需项。 仅允许使用当前磁盘上的路径。

directory\filename
将名为 filename.asm 的列表文件置于指定的目录中。 此参数形式仅在编译单个源代码文件时才有效。

directory\filename.extension
将名为 filename.extension 的列表文件置于指定的目录中。 此参数形式仅在编译单个源代码文件时才有效。

在 Visual Studio 开发环境中设置此编译器选项

  1. 打开项目的“属性页” 对话框。 有关详细信息,请参阅在 Visual Studio 中设置 C++ 编译器和生成属性

  2. 选择“配置属性”>“C/C++”>“输出文件”属性页 。

  3. 修改“汇编程序输出”属性,为汇编程序、计算机和源代码设置 /FAc 和 /FAs 选项。 修改“将 Unicode 用于汇编程序列表”属性,为 ANSI 或 UTF-8 输出设置 /FAu 选项。 修改“ASM 列表位置”,为列表文件名和位置设置 /Fa 选项。

同时设置“汇编程序输出”和“将 Unicode 用于汇编程序列表”属性可能会导致发出命令行警告 D9025。 若要在 IDE 中合并这些选项,请改用“命令行”属性页中的“附加选项”字段。

以编程方式设置此编译器选项

示例

以下命令行将生成名为 HELLO.cod 的源代码和计算机代码组合列表:

CL /FAcs HELLO.CPP

另请参阅

输出文件 (/F) 选项
MSVC 编译器选项
MSVC 编译器命令行语法
指定路径名