/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.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
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應