/FA, /Fa (Fichier de référencement)

  • Article

Crée un fichier de liste contenant du code assembleur.

Syntaxe

/FA[c][s][u]
/FaChemin

Notes

L’option /FA du compilateur génère un fichier de référencement d’assembleur pour chaque unité de traduction dans la compilation, qui correspond généralement à un fichier source C ou C++. Par défaut, seul l’assembleur est inclus dans le fichier de référencement, qui est encodé en tant qu’ANSI. Arguments facultatifs et u facultatifs scpour /FA contrôler si le code machine ou le code source sont générés avec la liste de l’assembleur et si la description est encodée en UTF-8.

Par défaut, chaque fichier de liste obtient le même nom de base que le fichier source et a une .asm extension. Lorsque le code de l’ordinateur est inclus à l’aide de l’option c , le fichier de description a une .cod extension. Vous pouvez modifier le nom et l’extension du fichier de liste et du répertoire où il est créé à l’aide de l’option /Fa .

Arguments /FA

aucune
Seule la langue de l’assembleur est incluse dans la liste.

c
facultatif. Inclut le code de l’ordinateur dans la liste.

s
facultatif. Inclut le code source dans la liste.

u
facultatif. Encode le fichier de référencement au format UTF-8 et inclut un marqueur d’ordre d’octet. Par défaut, le fichier est encodé en tant qu’ANSI. Permet u de créer un fichier de liste qui s’affiche correctement sur n’importe quel système ou si vous utilisez des fichiers de code source Unicode comme entrée au compilateur.

Si les deux s et u sont spécifiés, et si un fichier de code source utilise un encodage Unicode autre que UTF-8, les lignes de code du .asm fichier peuvent ne pas s’afficher correctement.

Argument /Fa

aucune
Un fichier source.asm est créé pour chaque fichier de code source dans la compilation.

nom_fichier
Le compilateur place un fichier de liste nommé filename.asm dans le répertoire actif. Ce formulaire d’argument est valide uniquement lors de la compilation d’un fichier de code source unique.

filename.extension
Le compilateur place un fichier de liste nommé filename.extension dans le répertoire actif. Ce formulaire d’argument est valide uniquement lors de la compilation d’un fichier de code source unique.

directory\
Le compilateur crée un fichier source_file.asm pour chaque fichier de code source dans la compilation. Il est placé dans le répertoire spécifié. La barre oblique inverse de fin est requise. Seuls les chemins d’accès sur le disque actuel sont autorisés.

nom de fichier d’annuaire\
Un fichier de référencement nommé filename.asm est placé dans le répertoire spécifié. Ce formulaire d’argument est valide uniquement lors de la compilation d’un fichier de code source unique.

directory\filename.extension
Un fichier de référencement nommé filename.extension est placé dans le répertoire spécifié. Ce formulaire d’argument est valide uniquement lors de la compilation d’un fichier de code source unique.

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é Assembleur Output pour définir les options /FAc et /FAs pour l’assembleur, l’ordinateur et le code source. Modifiez la propriété Use Unicode For Assemble Listing pour définir l’option pour la /FAu sortie ANSI ou UTF-8. Modifiez l’emplacement de liste ASM pour définir l’option permettant de répertorier le nom et l’emplacement /Fa du fichier.

La définition de la sortie de l’assembleur et l’utilisation des propriétés Unicode pour la description de l’assembleur peut entraîner l’avertissement de ligne de commande D9025. Pour combiner ces options dans l’IDE, utilisez le champ Options supplémentaires dans la page de propriétés de ligne de commande à la place.

Pour définir cette option du compilateur par programmation

Exemple

La ligne de commande suivante produit une liste de code source et machine combinée appelée HELLO.cod:

CL /FAcs HELLO.CPP

Voir aussi

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