/FA, /Fa (Eintragsdatei)

  • Artikel

Erstellt eine Auflistungsdatei mit Assemblercode.

Syntax

/FA[][c][s][u]
/FaPfadname

Hinweise

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

Standardmäßig erhält jede Eintragsdatei denselben Basisnamen wie die Quelldatei und verfügt über eine .asm Erweiterung. Wenn Computercode mithilfe der c Option enthalten ist, hat die Eintragsdatei eine .cod Erweiterung. Sie können den Namen und die Erweiterung der Eintragsdatei und des Verzeichnisses ändern, in dem sie mithilfe der /Fa Option erstellt wird.

/FA-Argumente

none
In der Auflistung ist nur die Assemblersprache enthalten.

c
Optional. Enthält Computercode in der Auflistung.

s
Optional. Enthält Quellcode in der Auflistung.

u
Optional. Codiert die Eintragsdatei im UTF-8-Format und enthält eine Bytereihenfolgenmarkierung. Standardmäßig ist die Datei als ANSI codiert. Dient u zum Erstellen einer Auflistungsdatei, die auf jedem System ordnungsgemäß angezeigt wird, oder wenn Sie Unicode-Quellcodedateien als Eingabe für den Compiler verwenden.

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

/Fa-Argument

none
Für jede Quellcodedatei in der Kompilierung wird eine Source.asm-Datei erstellt.

filename
Der Compiler platziert eine Auflistungsdatei namens "filename.asm" im aktuellen Verzeichnis. Dieses Argumentformular ist nur gültig, wenn eine einzelne Quellcodedatei kompiliert wird.

filename.extension
Der Compiler platziert eine Auflistungsdatei namens filename.extension im aktuellen Verzeichnis. Dieses Argumentformular ist nur gültig, wenn eine einzelne Quellcodedatei kompiliert wird.

verzeichnis\
Der Compiler erstellt eine source_file.asm-Datei für jede Quellcodedatei in der Kompilierung. Sie wird in das angegebene Verzeichnis eingefügt. Der nachfolgende umgekehrte Schrägstrich ist erforderlich. Es sind nur Pfade auf dem aktuellen Datenträger zulässig.

Verzeichnisdateiname\
Eine Eintragsdatei mit dem Namen "filename.asm " wird im angegebenen Verzeichnis platziert. Dieses Argumentformular ist nur gültig, wenn eine einzelne Quellcodedatei kompiliert wird.

directory\filename.extension
Eine Eintragsdatei namens filename.extension wird in das angegebene Verzeichnis eingefügt. Dieses Argumentformular ist nur gültig, wenn eine einzelne Quellcodedatei kompiliert wird.

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 Assembler Output-Eigenschaft , um die Optionen /FAc und /FAs für Assembler, Computer und Quellcode festzulegen. Ändern Sie die Eigenschaft "Unicode Für Assembler Listing 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 Dateinamen und Speicherort festzulegen.

Das Festlegen der Assemblerausgabe und der Verwendung von Unicode für assembler Listing-Eigenschaften 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 der Befehlszeile .

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Die folgende Befehlszeile erzeugt eine kombinierte Quell- und Computercodeauflistung namens HELLO.cod:

CL /FAcs HELLO.CPP

Siehe auch

Ausgabedatei (/F) Optionen
MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile
Festlegen des Pfadnamens