/FA
, /Fa
(файл перечисления)
Создает файл перечисления, содержащий код сборщика.
Синтаксис
/FA
[c
][s
][u
]
/Fa
Путь
Замечания
Параметр /FA
компилятора создает файл перечисления сборщика для каждой единицы перевода в компиляции, которая обычно соответствует исходному файлу C или C++. По умолчанию в файл перечисления входит только сборщик, который закодирован как ANSI. Необязательные c
s
аргументы и u
аргументы для /FA
управления выводом кода компьютера или исходного кода вместе со списком сборщика и кодированием в виде UTF-8.
По умолчанию каждый файл перечисления получает то же базовое имя, что и исходный .asm
файл, и имеет расширение. Если код компьютера включен с помощью c
параметра, файл перечисления имеет .cod
расширение. Вы можете изменить имя и расширение файла перечисления и каталог, в котором он создан с помощью /Fa
параметра.
Аргументы /FA
ничего
В список входит только язык сборщика.
c
Необязательно. Включает в себя код компьютера в списке.
s
Необязательно. Содержит исходный код в списке.
u
Необязательно. Кодирует файл перечисления в формате UTF-8 и включает маркер порядка байтов. По умолчанию файл закодирован как ANSI. Используется u
для создания файла перечисления, который отображается правильно в любой системе или если вы используете файлы исходного кода Юникода в качестве входных данных компилятору.
s
Если оба и u
задано, и если файл исходного кода использует кодировку Юникода, отличной от UTF-8, строки кода в .asm
файле могут отображаться неправильно.
Аргумент /Fa
ничего
Для каждого файла исходного кода в компиляции создается один файл source.asm .
filename
Компилятор помещает в текущий каталог файл с именем filename.asm. Эта форма аргумента допустима только при компиляции одного файла исходного кода.
filename.extension
Компилятор помещает в текущий каталог файл с именем filename.extension . Эта форма аргумента допустима только при компиляции одного файла исходного кода.
directory\
Компилятор создает один файл source_file.asm для каждого файла исходного кода в компиляции. Он помещается в указанный каталог. Требуется обратная косая черта. Разрешены только пути на текущем диске.
имя файла каталога\
Файл с именем filename.asm помещается в указанный каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.
directory\filename.extension
Файл с именем filename.extension помещается в указанный каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.
Установка данного параметра компилятора в среде разработки Visual Studio
Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.
Перейдите на страницу свойств Свойства конфигурации>C/C++>Выходные файлы.
Измените свойство вывода сборщика, чтобы задать параметры /FAc и /FAs для сборщика, компьютера и исходного кода. Измените свойство Use Unicode For Assembler Listing , чтобы задать
/FAu
параметр для выходных данных ANSI или UTF-8. Измените расположение списка ASM, чтобы задать/Fa
параметр для перечисления имени файла и расположения.
Установка выходных данных и использование Юникода для перечисления сборщика может вызвать предупреждение командной строки D9025. Чтобы объединить эти параметры в интегрированной среде разработки, используйте поле "Дополнительные параметры " на странице свойств командной строки .
Установка данного параметра компилятора программным способом
- См. описания свойств AssemblerListingLocation и AssemblerOutput. Чтобы указать /FAu, см. раздел AdditionalOptions.
Пример
Следующая командная строка создает объединенный исходный и машинный код с именем HELLO.cod
:
CL /FAcs HELLO.CPP
См. также
Параметры выходного файла (/F)
Параметры компилятора MSVC
Синтаксис командной строки компилятора MSVC
Указание пути