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

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

/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

Для каждого файла исходного кода в компиляции создается один файл с именем исходный_файл.asm.

/Fafilename

Файл имяфайла.asm будет размещен в текущем каталоге. Допускается только при компиляции одиночного файла исходного кода.

/Faимяфайла.расширение

Файл имяфайла.расширение будет размещен в текущем каталоге. Допускается только при компиляции одиночного файла исходного кода.

/Faкаталог

Для каждого файла исходного кода в компиляции создается один файл с именем исходный_файл.asm, размещаемый в каталоге каталог. Обратите внимание на обязательную косую черту в конце. Допускаются только пути на локальных дисках.

/Faкаталог\имяфайла

Файл имяфайла.asm помещается в указанный каталог directory. Допускается только при компиляции одиночного файла исходного кода.

/Faкаталог\имяфайла.расширение

Файл имяфайла.расширение будет размещен в каталоге directory. Допускается только при компиляции одиночного файла исходного кода.

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

  1. Откройте диалоговое окно Страницы свойств проекта. Дополнительные сведения см. в разделе Установка свойств проекта Visual C++.

  2. Щелкните папку C/C++.

  3. Выберите страницу свойств Выходные файлы.

  4. Измените значение свойства Местоположение ASM-списка (/Fa) или Файл ассемблерного кода (/FA); параметр /FAu задается на странице свойств Командная строка в поле Дополнительные параметры.

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

Пример

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

CL /FAcs HELLO.CPP

См. также

Ссылки

Параметры выходного файла (/F)

Параметры компилятора

Настройка параметров компилятора

Указание пути