/FA
, /Fa
(Arquivo de listagem)
Cria um arquivo de listagem que contém o código do assembler.
Sintaxe
/FA
[c
][s
][u
]
/Fa
pathname
Comentários
A opção do compilador /FA
gera um arquivo de listagem do assembler para cada unidade de tradução na compilação, que geralmente corresponde a um arquivo de origem do C ou C++. Por padrão, somente o assembler é incluído no arquivo de listagem, que é codificado como ANSI. Os argumentos opcionais c
, s
e u
para /FA
controlam se o código de máquina ou o código-fonte são gerados junto com a listagem do assembler e se a listagem é codificada em UTF-8.
Por padrão, cada arquivo de listagem obtém o mesmo nome de base que o arquivo de origem e tem uma extensão .asm
. Quando o código de máquina é incluído usando a opção c
, o arquivo de listagem tem uma extensão .cod
. Você pode alterar o nome e a extensão do arquivo de listagem e o diretório em que ele é criado usando a opção /Fa
.
Argumentos de /FA
nenhum
Somente a linguagem do assembler está incluída na listagem.
c
Opcional. Inclui o código de máquina na listagem.
s
Opcional. Inclui o código-fonte na listagem.
u
Opcional. Codifica o arquivo de listagem no formato UTF-8 e inclui um marcador de ordem de byte. Por padrão, o arquivo é codificado em ANSI. Use u
para criar um arquivo de listagem que é exibido corretamente em qualquer sistema ou se você estiver usando arquivos de código-fonte Unicode como entrada para o compilador.
Se s
e u
forem especificados e se um arquivo de código-fonte usar uma codificação Unicode diferente de UTF-8, as linhas de código no arquivo .asm
poderão não ser exibidas corretamente.
Argumento /Fa
nenhum
Um arquivo source.asm é criado para cada arquivo de código-fonte na compilação.
filename
O compilador coloca um arquivo de listagem chamado filename.asm no diretório atual. Esse formato de argumento só é válido ao compilar um único arquivo de código-fonte.
filename.extension
O compilador coloca um arquivo de listagem chamado filename.extension no diretório atual. Esse formato de argumento só é válido ao compilar um único arquivo de código-fonte.
diretório\
O compilador cria um arquivo source_file.asm para cada arquivo de código-fonte na compilação. Ele é colocado no diretório especificado. A barra invertida à direita é necessária. Somente caminhos do disco atual são permitidos.
directory\filename
Um arquivo de listagem chamado filename.asm é colocado no diretório especificado. Esse formato de argumento só é válido ao compilar um único arquivo de código-fonte.
directory\filename.extension
Um arquivo de listagem chamado filename.extension é colocado no diretório especificado. Esse formato de argumento só é válido ao compilar um único arquivo de código-fonte.
Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio
Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.
Selecione a página de propriedades Propriedades da Configuração>C/C++>Arquivos de Saída.
Modifique a propriedade Saída do Assembler para definir as opções /FAc e /FAs para o assembler, o computador e o código-fonte. Modifique a propriedade Usar Unicode para Listagem do Assembler para definir a opção
/FAu
como saída ANSI ou UTF-8. Modifique o Local da Lista do ASM para definir a opção/Fa
para o nome e o local do arquivo de listagem.
A definição das propriedades Saída do Assembler e Usar Unicode para Listagem do Assembler pode causar o Aviso de linha de comando D9025. Para combinar essas opções no IDE, use o campo Opções Adicionais na página de propriedade Linha de Comando.
Para definir essa opção do compilador via programação
- Consulte AssemblerListingLocation ou AssemblerOutput. Para especificar /FAu, confira AdditionalOptions.
Exemplo
A linha de comando a seguir produz uma listagem de código-fonte e de código de máquina combinada chamada HELLO.cod
:
CL /FAcs HELLO.CPP
Confira também
Opções do arquivo de saída (/F)
Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC
Especificando o nome de caminho