/FA, /Fa (Listendatei)

Aktualisiert: November 2007

Erstellt eine Listendatei, die Assemblycode enthält

/FA[c|s|u]
/Fapathname

Hinweise

Die Argumente legen die Erzeugung von Quell- und Maschinencode und die Erweiterung der Listendatei wie folgt fest:

In der folgenden Tabelle sind die verschiedenen Werte für /FA beschrieben. Es besteht die Möglichkeit, mehr als einen Wert für /FA anzugeben. Sie können beispielsweise /FAsu angeben.

Option

Listeninhalt und Dateierweiterung

/FA

Assemblycode; ASM

/FAc

Maschinen- und Assemblycode; COD

/FAs

Quell- und Assemblycode; ASM

Wenn /FAcs angegeben wird, wird als Dateierweiterung .cod verwendet.

/FAu

Führt dazu, dass die Ausgabedatei im UTF-8-Format mit einer Bytereihenfolgenmarkierung erstellt wird. In der Standardeinstellung wird die Datei mit ANSI codiert. Sie sollten jedoch /FAu verwenden, wenn Sie eine Listendatei erstellen möchten, die auf jedem System ordnungsgemäß dargestellt wird, oder wenn Sie für die Eingabe in den Compiler Quellcodedateien im Unicode-Format verwenden.

Wenn /FAsu angegeben wird, und wenn eine Quellcodedatei in einem von UTF-8 verschiedenem Unicode-Format codiert ist, werden die Codezeilen in der .asm-Datei unter Umständen nicht ordnungsgemäß dargestellt.

Standardmäßig erhält die Listendatei denselben Basisnamen wie die Quelldatei. Sie können den Namen der Listendatei und des Verzeichnisses, in dem sie erstellt wird, mithilfe der /Fa-Option ändern.

Verwendung von /Fa

Ergebnis

/Fa

Für jede Quellcodedatei in der Kompilierung wird eine Datei mit dem Namen source_file.asm erstellt.

/Fafilename

Die Datei filename.asm wird im aktuellen Verzeichnis abgelegt. Nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

/Fafilename.extension

Die Datei filename.extension wird im aktuellen Verzeichnis abgelegt. Nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

/Fadirectory\

Für jede Quellcodedatei in der Kompilierung wird eine Datei mit dem Namen source_file.asm erstellt und im angegebenen directory abgelegt. Beachten Sie, dass ein nachgestellter umgekehrter Schrägstrich erforderlich ist. Nur Pfade auf der aktuellen Festplatte sind zulässig.

/Fadirectory\filename

Die Datei filename.asm wird im angegebenen directory abgelegt. Nur beim Kompilieren einer einzelnen Quellcodedatei gültig.

/Fadirectory\filename.extension

filename.extension wird im angegebenen directory eingefügt. 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. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.

  2. Klicken Sie auf den Ordner C/C++.

  3. Klicken Sie auf die Eigenschaftenseite Ausgabedateien.

  4. Ändern Sie die Eigenschaft ASM-Listenspeicherort (/Fa) oder Assemblyausgabe (/FA) (/FAu muss in der Eigenschaftenseite für die Befehlszeile im Feld Zusätzliche Optionen angegeben werden).

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Die nachfolgende Befehlszeile produziert eine kombinierte Liste mit Quellcode und Maschinencode mit dem Namen HELLO.cod.

CL /FAcs HELLO.CPP

Siehe auch

Referenz

/F-Optionen (Ausgabedateioptionen)

Compileroptionen

Festlegen von Compileroptionen

Festlegen des Pfadnamens