/FA
、 /Fa
(列出檔案)
建立包含彙編程式程式代碼的清單檔案。
語法
/FA
[c
][s
][u
]
/Fa
路徑
備註
編譯 /FA
程式選項會針對編譯中的每個轉譯單位產生組合器清單檔案,這通常對應至 C 或C++原始程序檔。 根據預設,只會將彙編程式包含在清單檔案中,該檔案會編碼為 ANSI。 選擇性 c
、 s
和 u
自變數,可 /FA
控制機器碼或原始程式碼是否與組合器清單一起輸出,以及清單是否編碼為UTF-8。
根據預設,每個清單檔案都會取得與原始程式檔相同的基底名稱,而且擴展名為 .asm
。 使用 c
選項包含機器碼時,清單檔案具有 .cod
擴展名。 您可以使用 選項來變更清單檔案的名稱和擴展名,以及其建立 /Fa
所在的目錄。
/FA
引數
none
清單中只會包含彙編語言。
c
選擇性。 在清單中包含機器碼。
s
選擇性。 在清單中包含原始程式碼。
u
選擇性。 以UTF-8格式編碼清單檔案,並包含位元組順序標記。 根據預設,檔案會編碼為 ANSI。 使用 u
來建立在任何系統上正確顯示的清單檔,或者如果您使用 Unicode 原始碼檔案作為編譯程式的輸入。
如果同時 s
指定 和 u
,而且原始程式碼檔案使用 UTF-8 以外的 Unicode 編碼,則檔案中的 .asm
程式代碼行可能無法正確顯示。
/Fa
論點
none
編譯中的每個原始程式碼檔案都會建立一個 source.asm 檔案。
filename
編譯程式會將名為 filename.asm 的清單檔案放在目前目錄中。 只有在編譯單一原始程式碼檔案時,這個自變數窗體才有效。
filename.extension
編譯程式會將名為 filename.extension 的清單檔放在目前目錄中。 只有在編譯單一原始程式碼檔案時,這個自變數窗體才有效。
目錄\
編譯程式會針對編譯中的每個原始程式碼檔案建立一個 source_file.asm 檔案。 它會放在指定的 目錄中。 需要尾端反斜杠。 只允許目前磁碟上的路徑。
目錄\檔名
名為 filename.asm 的清單檔案會放在指定的目錄中。 只有在編譯單一原始程式碼檔案時,這個自變數窗體才有效。
directory\filename.extension
名為 filename.extension 的清單檔案會放在指定的 目錄中。 只有在編譯單一原始程式碼檔案時,這個自變數窗體才有效。
在 Visual Studio 開發環境中設定這個編譯器選項
開啟專案的 [屬性頁] 對話方塊。 如需詳細資料,請參閱在 Visual Studio 中設定 C ++ 編譯器和組建屬性。
選取 [組態屬性]>C/C++>[輸出檔案] 屬性頁。
修改 Assembler Output 屬性,以設定組合器、計算機和原始程式碼的 /FAc 和 /FA 選項。 修改 [使用 Unicode For Assembler List] 屬性來設定
/FAu
ANSI 或 UTF-8 輸出的選項。 修改 ASM 清單位置,以設定/Fa
列出檔名和位置的選項。
設定組合器輸出和使用 Unicode 進行組合器清單屬性可能會導致命令行警告 D9025。 若要在 IDE 中結合這些選項,請改用命令行屬性頁中的 [其他選項] 字段。
若要以程式方式設定這個編譯器選項
- 請參閱 AssemblerListingLocation或 AssemblerOutput。 若要指定 /FAu,請參閱 AdditionalOptions。
範例
下列命令列會產生稱為 HELLO.cod
的合併來源和電腦程式代碼清單:
CL /FAcs HELLO.CPP