/FA, /Fa (Fichier listing)

Mise à jour : novembre 2007

Crée un fichier listing qui contient le code assembleur.

/FA[c|s|u]
/Fapathname

Notes

Les arguments déterminent la génération du code source et du code machine ainsi que l'extension du fichier listing.

Le tableau suivant décrit les différentes valeurs de /FA. Il est possible de spécifier plusieurs valeurs pour /FA. Par exemple, vous pouvez effectuer /FAsu.

Option

Contenu du listing et extension de fichier

/FA

Code assembleur ; .asm

/FAc

Code assembleur et machine ; .cod

/FAs

Code assembleur et source ; .asm

Si /FAcs est spécifié, l'extension de fichier est .cod

/FAu

Entraîne la création du fichier de sortie au format UTF-8, avec un marqueur d'ordre d'octet. Par défaut, le codage de fichier est ANSI, mais utilisez /FAu si vous souhaitez un fichier listing qui s'affiche correctement sur tout système, ou si vous utilisez des fichiers de code source Unicode comme entrées dans le compilateur.

Si /FAsu est spécifié, et si un fichier de code source utilise un codage Unicode autre que UTF-8, les lignes de code contenues dans le fichier .asm risquent de ne pas s'afficher correctement.

Par défaut, le fichier listing prend le même nom de base que le fichier source. Vous pouvez modifier le nom du fichier listing et le répertoire où il est créé à l'aide de l'option /Fa.

Utilisation de /Fa

Résultat

/Fa

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

/FaNomFichier

NomFichier.asm est placé dans le répertoire actif. Valide seulement lors de la compilation d'un seul fichier de code source.

/FaNomFichier.Extension

NomFichier.Extension est placé dans le répertoire actif. Valide seulement lors de la compilation d'un seul fichier de code source.

/FaRépertoire\

Un fichier_source.asm est créé et placé dans le répertoire spécifié pour chaque fichier de code source de la compilation. Notez la présence de la barre oblique inverse obligatoire. Seuls les chemins d'accès sur le disque actif sont admis.

/FaRépertoire\NomFichier

NomFichier.asm est placé dans le directory spécifié. Valide seulement lors de la compilation d'un seul fichier de code source.

/FaRépertoire\NomFichier.Extension

NomFichier.Extension est placé dans le directoryspécifié. Valide seulement lors de la compilation d'un seul fichier de code source.

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éfinition des propriétés de projets Visual C++.

  2. Cliquez sur le dossier C/C++.

  3. Cliquez sur la page de propriétés Fichiers de sortie.

  4. Modifiez la propriété Emplacement d'un listing ASM (/Fa) ou Sortie de l'assembleur (/FA) (/FAu doit être spécifié dans la page de propriétés Ligne de commande, zone Options supplémentaires.

Pour définir cette option du compilateur par programme

Exemple

La ligne de commande suivante produit un listing appelé HELLO.cod combinant code source et code machine :

CL /FAcs HELLO.CPP

Voir aussi

Référence

Options du fichier de sortie (/F)

Options du compilateur

Définition des options du compilateur

Spécification du nom de chemin