/Fo (Objektdateiname)

  • Artikel

Gibt einen Objekt (.obj)-Dateinamen oder ein Verzeichnis an, das anstelle des Standards verwendet werden soll.

Syntax

/Fo"pathname"
/Fo:[ ]"pathname"

Hinweise

Sie können die /Fo-Compileroption verwenden, um ein Ausgabeverzeichnis für alle Objektdateien festzulegen, die vom CL-Compilerbefehl generiert wurden. Oder Sie können damit eine einzelne Objektdatei umbenennen. Platzieren Sie kein Leerzeichen zwischen der /Fo-Option und dem pathname-Argument.

Standardmäßig werden die vom Compiler generierten Objektdateien im aktuellen Verzeichnis platziert. Sie erhalten den Basisnamen der Quelldatei und eine .obj-Erweiterung.

Um die /Fo-Option zum Umbenennen einer Objektdatei zu verwenden, geben Sie den Ausgabedateinamen als pathname-Argument an. Wenn Sie eine Objektdatei umbenennen, können Sie einen beliebigen Namen und jede gewünschte Erweiterung verwenden, aber die empfohlene Konvention besteht darin, eine .obj-Erweiterung zu verwenden. Der Compiler generiert den Befehlszeilenfehler D8036, wenn Sie einen Dateinamen an /Fo angeben, wenn Sie mehrere Quelldateien zum Kompilieren angegeben haben.

Um die /Fo-Option zum Festlegen eines Ausgabeverzeichnisses für alle Objektdateien zu verwenden, die vom CL-Befehl erstellt wurden, geben Sie das Verzeichnis als pathname-Argument an. Ein Verzeichnis wird durch einen nachgestellten Schrägstrich oder umgekehrten Schrägstrich im pathname-Argument angegeben. Verwenden Sie einen escaped backslash (einen doppelten umgekehrten Schrägstrich), wenn Sie einen in Anführungszeichen gesetzten Pfad verwenden. Der Verzeichnispfad kann absolut oder relativ zum Quellverzeichnis sein. Das angegebene Verzeichnis muss vorhanden sein, oder der Compiler meldet den Fehler D8003. Das Verzeichnis wird nicht automatisch erstellt.

Beispiel

Diese Befehlszeile veranschaulicht das Format, das ein optionales Leerzeichen zwischen der /Fo-Option und dem pathname-Argument ermöglicht. Es erstellt eine Objektdatei, die im aktuellen Verzeichnis test.obj genannt ist.

CL /Fo: "test" /EHsc /c sample1.cpp

In der folgenden Befehlszeile werden Objektdateien namens sample1.obj und sample2.obj in einem vorhandenen Verzeichnis D:\intermediate\ erstellt. Es verwendet escaped backslash-Zeichen als Pfadsegmenttrennzeichen in einem in Anführungszeichen gesetzten Pfad:

CL /Fo"D:\\intermediate\\" /EHsc /c sample1.cpp sample2.cpp

Diese Befehlszeile erstellt Objektdateien namens sample1.obj und sample2.obj in einem vorhandenen Verzeichnis output\, relativ zum Quellverzeichnis.

CL /Fooutput\ /EHsc /c sample1.cpp sample2.cpp

Festlegen der Option in Visual Studio oder programmgesteuert

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 Eigenschaft Objektdateiname, um das Ausgabeverzeichnis festzulegen. In der IDE müssen die Objektdateien eine Erweiterung von .obj aufweisen.

So legen Sie diese Compileroption programmgesteuert fest

Siehe auch

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