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

Статья
06/09/2015

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

/FA[c|s|u]
/Fapathname

Заметки

Аргументы определяют порядок формирования исходного и машинного кода, а также задают расширение файла листинга.

В следующей таблице описаны различные значения для параметра /FA. В параметре /FA можно указывать несколько значений. Например, можно задать параметр /FAsu.

Команда	Содержимое листинга и расширение файла
/FA	Код на языке ассемблера; ASM
/FAc	Машинный код и код на языке ассемблера; COD
/FAs	Исходный код и код на языке ассемблера; ASM При использовании параметра /FAcs файл будет иметь расширение COD
/FAu	Выходной файл будет создан в формате UTF-8 с отметкой порядка байтов. По умолчанию файл будет иметь кодировку ANSI, но если нужно создать файл листинга, который будет правильно отображаться на любой системе, или же если в качестве входных данных компилятора используются файлы исходного кода в кодировке Юникод, то следует использовать параметр /FAu. Если указан параметр /FAsu, и файл исходного кода имеет кодировку Юникод, а не UTF-8, то строки кода в файле ASM могут отображаться неправильно.

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

Использование параметра /Fa	Результат
/Fa	Один файл source_file.asm создается для каждого файла исходного кода в компиляции.
/Fafilename	filename ASM-файле помещается в текущем каталоге. Допускается только при компиляции одиночного файла исходного кода.
/Fafilename.extension	filename.extension помещается в текущем каталоге. Допускается только при компиляции одиночного файла исходного кода.
/Fadirectory\	source_file создается одно ASM-файле и помещается в определенном directory для каждого файла исходного кода в компиляции. Обратите внимание на обязательную косую черту в конце. Допускаются только пути на локальных дисках.
/Fadirectory\filename	filename ASM-файле помещается в определенном directory. Допускается только при компиляции одиночного файла исходного кода.
/Fadirectory\filename.extension	filename.extension помещается в определенном directory. Допускается только при компиляции одиночного файла исходного кода.

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

Откройте диалоговое окно Страницы свойств проекта. Дополнительные сведения см. в разделе Задание свойств проекта C++.
Откройте папку C/C++.
Выберите страницу свойств Выходные файлы.
Измените значение свойства Местоположение ASM-списка (/Fa) или Файл ассемблерного кода (/FA); параметр /FAu задается на странице свойств Командная строка в поле Дополнительные параметры.