/FA, /Fa (Файл листинга)

Создает файл листинга, содержащий код ассемблера.

Синтаксис

/FA[c][s][u]
/Faконтура

Remarks

/FA Параметр компилятора создает файл листинга ассемблера для каждой записи преобразования в компиляции, которая обычно соответствует исходному файлу C или C++. По умолчанию в файл листинга включается только ассемблер, который кодируется как ANSI. Необязательные c s аргументы, и u /FA используются для управления выводом машинного кода или исходного кода вместе со списком ассемблера, а также сведения о том, кодируется ли список как UTF-8.

По умолчанию каждый файл списка получает то же базовое имя, что и исходный файл, и имеет .asm расширение. При включении машинного кода с c параметром файл списка имеет .cod расширение. Можно изменить имя и расширение файла листинга и каталога, в котором он создается, с помощью /Fa параметра.

Аргументы /FA

None В список включен только язык ассемблера.

c
Необязательный параметр. Включает машинный код в список.

s
Необязательный параметр. Включает исходный код в список.

u
Необязательный параметр. Кодирует файл листинга в формате UTF-8 и включает метку порядка байтов. По умолчанию файл кодируется как ANSI. Используйте u для создания файла листинга, который правильно отображается в любой системе, или если в качестве входных данных для компилятора используются файлы исходного кода в Юникоде.

Если s указаны и u , и, и если в файле исходного кода используется кодировка Юникод, отличная от UTF-8, то строки кода в .asm файле могут отображаться неправильно.

Аргумент /Fa

None Один Исходный ASM -файл создается для каждого файла исходного кода при компиляции.

файлов
Компилятор помещает файл листинга с именем filename. ASM в текущий каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.

имя файла. расширение
Компилятор помещает файл листинга с именем filename. extension в текущий каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.

каталоги\
Компилятор создает один файл source_file. ASM для каждого файла исходного кода при компиляции. Он помещается в указанный Каталог. Обратная косая черта обязательна. Разрешены только пути на текущем диске.

Каталог \ имя файла
Файл листинга с именем filename. ASM помещается в указанный Каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.

Каталог \ имя файла. расширение
Файл листинга с именем filename. extension помещается в указанный Каталог. Эта форма аргумента допустима только при компиляции одного файла исходного кода.

Установка данного параметра компилятора в среде разработки Visual Studio

  1. Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.

  2. Перейдите на страницу свойств Свойства конфигурации > C/C++ > Выходные файлы.

  3. Измените свойство выходные данные ассемблера , чтобы задать параметры /fac и /FAS для ассемблера, компьютера и исходного кода. Измените свойство использовать Юникод для ассемблерного списка , чтобы задать /FAu параметр для выходных данных ANSI или UTF-8. Измените Расположение списка ASM , чтобы задать /Fa параметр для вывода имени и расположения файла.

Установка обоих выходных данных ассемблера и Использование Юникода для свойств листинга ассемблера может привести к D9025 предупреждений командной строки. Чтобы объединить эти параметры в интегрированной среде разработки, используйте поле Дополнительные параметры на странице свойств командной строки .

Установка данного параметра компилятора программным способом

Пример

Следующая командная строка создает Объединенный исходный код и листинг машинного кода с именем HELLO.cod :

CL /FAcs HELLO.CPP

См. также

Параметры OUTPUT-File (/F)
Параметры компилятора MSVC
MSVC Синтаксис Command-Line компилятора
Указание пути