/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
Откройте диалоговое окно Страницы свойств проекта. Дополнительные сведения см. в разделе Установка свойств проекта Visual C++.
Щелкните папку C/C++.
Выберите страницу свойств Выходные файлы.
Измените значение свойства Местоположение ASM-списка (/Fa) или Файл ассемблерного кода (/FA); параметр /FAu задается на странице свойств Командная строка в поле Дополнительные параметры.
Установка параметра компилятора программным способом
- См. разделы AssemblerListingLocation и AssemblerOutput. Сведения для параметра /FAu см. в разделе AdditionalOptions.
Пример
Следующая командная строка создаст объединенный листинг машинного и исходного кода с именем HELLO.cod:
CL /FAcs HELLO.CPP
См. также
Ссылки
Параметры выходного файла (/F)