/FA、/Fa (清單檔)
建立包含組譯程式碼的清單檔。
/FA[c|s|u]
/Fapathname
備註
引數可以控制原始程式碼和機器碼 (Machine Code) 的產生和清單檔的副檔名。
下表將描述 /FA 各個不同的值。 您可以指定一個以上的值給 /FA。 例如,您可以指定 /FAsu。
選項 |
清單內容和 副檔名 |
---|---|
/FA |
組譯程式碼;.asm |
/FAc |
機器碼和組譯程式碼;.cod |
/FAs |
原始程式碼和組譯程式碼;.asm 如果指定了 /FAcs,副檔名將會是 .cod |
/FAu |
會讓輸出檔以 UTF-8 格式建立,加上位元組順序標記。 檔案的編碼方式是預設為 ANSI,但是如果您要在任何系統上正確顯示的清單檔,或是如果使用 Unicode 原始程式碼檔案做為編譯器的輸入,則使用 /FAu。 如果已指定 /FAsu,而且如果原始程式碼檔案使用 Unicode 編碼方式而不用 UTF-8,則 .asm 檔中的程式碼行可能無法正確顯示。 |
根據預設,清單檔會使用與原始程式檔相同的主檔名 (Base Name)。 您可以使用 /Fa 選項變更清單檔的名稱和建立時所在的目錄。
/Fa 的使用 |
結果 |
---|---|
/Fa |
對編譯中的每一個原始程式碼檔案建立一個 source_file.asm。 |
/Fafilename |
filename.asm 會置於目前的目錄中。 只在編譯單一原始程式碼檔案時有效。 |
/Fafilename.extension |
filename.extension會置於目前的目錄中。 只在編譯單一原始程式碼檔案時有效。 |
/Fadirectory\ |
對編譯中的每一個原始程式碼檔案建立一個 source_file.asm,並將其置於指定的 directory 中。 請注意,必須要有後面的反斜線。 只允許目前磁碟機上的路徑。 |
/Fadirectory\filename |
filename.asm 會置於指定的 directory 中。 只在編譯單一原始程式碼檔案時有效。 |
/Fadirectory\filename.extension |
filename.extension置於指定的directory中。 只在編譯單一原始程式碼檔案時有效。 |
在 Visual Studio 開發環境中設定這個編譯器選項
開啟專案的 [屬性頁] 對話方塊。 如需詳細資訊,請參閱設定 Visual C++ 專案屬性。
按一下 [C/C++] 資料夾。
按一下 [輸出檔] 屬性頁。
修改 [ASM 清單位置] (/Fa) 或 [組合語言輸出] (/FA) 屬性 (必須在 [其他選項] 方塊的 [命令列] 屬性頁中指定 /FAu)。
若要以程式方式設定這個編譯器選項
- 請參閱 AssemblerListingLocation或 AssemblerOutput。 若要指定 /FAu,請參閱 AdditionalOptions。
範例
以下命令列會產生稱為 HELLO.cod 的原始程式碼和機器碼組合列表:
CL /FAcs HELLO.CPP