/FA、/Fa(列出文件)
创建包含程序集代码的清单文件。
/FA[c|s|u]
/Fapathname
备注
参数控制源代码和机器码的生成以及清单文件的扩展名。
下表描述 /FA 的各种不同的值。 可为 /FA 指定多个值。 例如,可以指定 /FAsu。
选项 |
清单内容和文件扩展名 |
---|---|
/FA |
程序集代码;.asm |
/FAc |
机器码和程序集代码;.cod |
/FAs |
源代码和程序集代码;.asm 如果指定了 /FAcs,则文件扩展名将为 .cod |
/FAu |
导致用 UTF-8 格式和字节顺序标记创建输出文件。 默认情况下,文件编码为 ANSI,但是如果您希望清单文件在所有系统中均正确显示,或者如果要使用 Unicode 源代码文件作为编译器的输入,则请使用 /FAu。 如果指定了 /FAsu,并且源代码文件使用 UTF-8 之外的 Unicode 编码,则 .asm 文件中的代码行可能无法正确显示。 |
默认情况下,清单文件获取与源文件相同的基名称。 使用 /Fa 选项可以更改清单文件的名称和在其中创建清单文件的目录。
/Fa 用法 |
结果 |
---|---|
/Fa |
为编译中的每个源代码文件创建一个 source_file.asm。 |
/Fafilename |
将 文件名.asm 放到当前目录中。 仅在编译单个源代码文件时有效。 |
/Fa文件名.扩展名 |
将 文件名.扩展名 放到当前目录中。 仅在编译单个源代码文件时有效。 |
/Fa目录\ |
为编译中的每个源代码文件创建一个 source_file.asm,并将其放到指定的 目录 中。 请注意必须有后缀反斜杠。 只允许使用当前磁盘上的路径。 |
/Fa目录\文件名 |
将 文件名.asm 放到指定的 directory 中。 仅在编译单个源代码文件时有效。 |
/Fa目录\文件名.扩展名 |
将 文件名.扩展名 放到指定的 directory 中。 仅在编译单个源代码文件时有效。 |
在 Visual Studio 开发环境中设置此编译器选项
打开项目的**“属性页”**对话框。 有关详细信息,请参见设置 Visual C++ 项目属性。
单击**“C/C++”**文件夹。
单击**“输出文件”**属性页。
修改**“ASM 列表位置”(/Fa**) 或**“汇编输出”(/FA**) 属性(必须在**“命令行”属性页的“附加选项”**框中指定 /FAu)。
以编程方式设置此编译器选项
- 请参见 AssemblerListingLocation 或 AssemblerOutput。 若要指定 /FAu,请参见 AdditionalOptions。
示例
下列命令行产生名为 HELLO.cod 的组合源代码和机器码清单:
CL /FAcs HELLO.CPP