/FA, /Fa (Auflistungsdatei)

Erstellt eine Auflistungsdatei mit Assemblercode.

Syntax

/FA[c][s][u]
/FaPfadnamen

Bemerkungen

Die /FA Compileroption generiert eine Assemblerauflistungsdatei für jede Übersetzungseinheit in der Kompilierung, die im Allgemeinen einer C- oder C++-Quelldatei entspricht. Standardmäßig ist nur der Assembler in der Auflistungsdatei enthalten, die als ANSI codiert ist. Die optionalen cArgumente , sund u , um zu steuern, /FA ob Computercode oder Quellcode zusammen mit der Assemblerauflistung ausgegeben werden und ob die Auflistung als UTF-8 codiert ist.

Standardmäßig erhält jede Auflistungsdatei den gleichen Basisnamen wie die Quelldatei und hat eine .asm Erweiterung. Wenn Computercode mithilfe der c -Option eingeschlossen wird, hat die Auflistungsdatei die .cod Erweiterung . Sie können den Namen und die Erweiterung der Auflistungsdatei und des Verzeichnisses, in dem sie erstellt wird, mithilfe der /Fa Option ändern.

/FA-Argumente

Keine
In der Auflistung ist nur die Assemblersprache enthalten.

c
Optional. Schließt Computercode in die Auflistung ein.

s
Optional. Schließt Quellcode in die Auflistung ein.

u
Optional. Codiert die Auflistungsdatei im UTF-8-Format und enthält einen Bytereihenfolgemarker. Standardmäßig wird die Datei als ANSI codiert. Verwenden Sie u , um eine Auflistungsdatei zu erstellen, die ordnungsgemäß auf jedem System angezeigt wird, oder , wenn Sie Unicode-Quellcodedateien als Eingabe für den Compiler verwenden.

Wenn sowohl als u auch s angegeben sind und eine Quellcodedatei eine andere Unicode-Codierung als UTF-8 verwendet, werden die Codezeilen in der .asm Datei möglicherweise nicht ordnungsgemäß angezeigt.

/Fa-Argument

Keine
Eine source.asm-Datei wird für jede Quellcodedatei in der Kompilierung erstellt.

filename
Der Compiler platziert eine Auflistungsdatei mit dem Namen filename.asm im aktuellen Verzeichnis. Dieses Argumentformular ist nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

filename.extension
Der Compiler platziert eine Auflistungsdatei namens filename.extension im aktuellen Verzeichnis. Dieses Argumentformular ist nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

Verzeichnis\
Der Compiler erstellt eine source_file.asm-Datei für jede Quellcodedatei in der Kompilierung. Sie wird im angegebenen Verzeichnis platziert. Der nachfolgende umgekehrte Schrägstrich ist erforderlich. Nur Pfade auf dem aktuellen Datenträger sind zulässig.

Verzeichnis\Dateiname
Eine Auflistungsdatei mit dem Namen filename.asm wird im angegebenen Verzeichnis platziert. Dieses Argumentformular ist nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

Verzeichnis\filename.extension
Eine Auflistungsdatei mit dem Namen filename.extension wird im angegebenen Verzeichnis platziert. Dieses Argumentformular ist nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Wählen Sie die Eigenschaftenseite Konfigurationseigenschaften>C/C++>Ausgabedateien aus.

  3. Ändern Sie die Output-Eigenschaft des Assemblers , um die Optionen /FAc und /FAs für Assembler, Computer und Quellcode festzulegen. Ändern Sie die Eigenschaft Use Unicode For Assembler Listing (Unicode für Assembler-Auflistung verwenden ), um die Option für die /FAu ANSI- oder UTF-8-Ausgabe festzulegen. Ändern Sie den ASM-Listenspeicherort , um die /Fa Option zum Auflisten von Dateiname und Speicherort festzulegen.

Das Festlegen der Eigenschaften Assemblerausgabe und Unicode für Assemblerlistung verwenden kann zu einer Befehlszeilenwarnung D9025 führen. Um diese Optionen in der IDE zu kombinieren, verwenden Sie stattdessen das Feld Zusätzliche Optionen auf der Eigenschaftenseite Befehlszeile .

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Die folgende Befehlszeile erzeugt eine kombinierte Quell- und Computercodeauflistung mit dem Namen HELLO.cod:

CL /FAcs HELLO.CPP

Siehe auch

Ausgabedateioptionen (/F)
MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile
Angeben des Pfadnamens