/Fo (nom de fichier objet)

  • Article

Spécifie un nom de fichier ou répertoire d’objet (.obj) à utiliser au lieu de la valeur par défaut.

Syntaxe

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

Notes

Vous pouvez utiliser l’option du compilateur /Fo pour définir un répertoire de sortie pour tous les fichiers objet générés par la commande du compilateur CL. Vous pouvez également l’utiliser pour renommer un seul fichier objet. Ne mettez pas d’espace entre l’option /Fo et l’argument pathname.

Par défaut, les fichiers objet générés par le compilateur sont placés dans le répertoire actuel. Ils reçoivent le nom de base du fichier source et une extension .obj.

Pour utiliser l’option /Fo qui permet de renommer un fichier objet, spécifiez le nom de fichier de sortie en tant qu’argument pathname. Lorsque vous renommez un fichier objet, vous pouvez utiliser n’importe quels nom et extension souhaités, mais la convention recommandée consiste à utiliser une extension .obj. Le compilateur génère une erreur de ligne de commande D8036 si vous spécifiez un nom de fichier sur /Fo lorsque vous avez spécifié plusieurs fichiers sources à compiler.

Pour utiliser l’option /Fo afin de définir un répertoire de sortie pour tous les fichiers objet créés par la commande CL, spécifiez le répertoire en tant qu’argument pathname. Un répertoire est indiqué par une barre oblique de fin ou une barre oblique inversée dans l’argument pathname. Utilisez une barre oblique inversée échappée (une double barre oblique inversée), si vous utilisez un chemin entre guillemets. Le chemin de répertoire peut être absolu ou relatif au répertoire source. Le répertoire spécifié doit exister, sans quoi le compilateur signale l’erreur D8003. Le répertoire n’est pas créé automatiquement.

Exemple

Cette ligne de commande illustre le format qui permet d’inclure un espace facultatif entre l’option /Fo et l’argument pathname. Il crée un fichier objet nommé test.obj dans le répertoire actuel.

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

La ligne de commande suivante crée des fichiers objet nommés sample1.obj et sample2.obj dans un répertoire existant, D:\intermediate\. Il utilise des caractères de barre oblique inversée échappée comme séparateurs de segments de ligne dans un chemin entre guillemets :

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

Cette ligne de commande crée des fichiers objet nommés sample1.obj et sample2.obj dans un répertoire existant, output\, par rapport au répertoire source.

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

Définir l’option dans Visual Studio ou par programmation

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Fichiers de sortie.

  3. Modifiez la propriété Nom de fichier objet pour définir le répertoire de sortie. Dans l’environnement de développement intégré (IDE), les fichiers objet doivent avoir une extension .obj.

Pour définir cette option du compilateur par programmation

Voir aussi

Options du fichier de sortie (/F)
Options du compilateur MSVC
Syntaxe de ligne de commande du compilateur MSVC
Spécification du nom de chemin