Compartilhar via


/Fo (Nome do Arquivo de Objeto)

Especifica um nome de arquivo ou o diretório de objeto (.obj) a ser usado em vez do padrão.

Sintaxe

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

Comentários

Você pode usar a opção do compilador /Fo para definir um diretório de saída para todos os arquivos-objetos gerados pelo comando do compilador CL. Ou pode usá-la para renomear um único arquivo-objeto. Não coloque um espaço entre a opção /Fo e o argumento pathname.

Por padrão, os arquivos-objetos gerados pelo compilador são colocados no diretório atual. Eles recebem o nome de base do arquivo de origem e uma extensão .obj.

Para usar a opção /Fo para renomear um arquivo de objeto, especifique o nome do arquivo de saída como argumento pathname. Ao renomear um arquivo de objeto, você pode usar qualquer nome e extensão que desejar, mas a convenção recomendada é usar uma extensão .obj. O compilador gerará o erro de linha de comando D8036 se você especificar um nome de arquivo para /Fo quando houver mais de um arquivo de origem especificado para compilar.

Para usar a opção /Fo para definir um diretório de saída para todos os arquivos de objeto criados pelo comando CL, especifique o diretório como o argumento pathname. Um diretório é indicado por uma barra final ou barra invertida no argumento pathname. Use uma barra invertida com escape (uma barra invertida dupla), se estiver usando um caminho entre aspas. O caminho do diretório pode ser absoluto ou relativo ao diretório de origem. O diretório especificado deve existir, ou o compilador relatará o erro D8003. O diretório não é criado automaticamente.

Exemplo

Essa linha de comando demonstra o formato que permite um espaço opcional entre a opção /Fo e o argumento pathname. Ele cria um arquivo de objeto chamado test.obj no diretório atual.

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

A linha de comando a seguir cria arquivos de objeto denominados sample1.obj e sample2.obj em um diretório existente, D:\intermediate\. Ele usa caracteres de barra invertida com escape como separadores de segmento de caminho em um caminho entre aspas:

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

Essa linha de comando cria arquivos de objeto denominados sample1.obj e sample2.obj em um diretório existente, output\, relativo ao diretório de origem.

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

Definir a opção no Visual Studio ou programaticamente

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 Nome de Arquivo do Objeto para definir o diretório de saída. No IDE, os arquivos de objeto devem ter uma extensão .obj.

Para definir essa opção do compilador via programação

Confira também

Arquivo de saída (/F) opções
Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC
Especificar o nome de caminho