Compartilhar via


/FA, /Fa (Arquivo de listagem)

Cria um arquivo de listagem que contém o código do assembler.

Sintaxe

/FA[c][s][u]
/Fapathname

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

  1. 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.

  2. Selecione a página de propriedades Propriedades da Configuração>C/C++>Arquivos de Saída.

  3. 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

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