/FA, /Fa (файл перечисления)

  • Статья

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

Синтаксис

/FA[c][s][u]
/FaПуть

Замечания

Параметр /FA компилятора создает файл перечисления сборщика для каждой единицы перевода в компиляции, которая обычно соответствует исходному файлу C или C++. По умолчанию в файл перечисления входит только сборщик, который закодирован как ANSI. Необязательные csаргументы и 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

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

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

  3. Измените свойство вывода сборщика, чтобы задать параметры /FAc и /FAs для сборщика, компьютера и исходного кода. Измените свойство Use Unicode For Assembler Listing , чтобы задать /FAu параметр для выходных данных ANSI или UTF-8. Измените расположение списка ASM, чтобы задать /Fa параметр для перечисления имени файла и расположения.

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

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

Пример

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

CL /FAcs HELLO.CPP

См. также

Параметры выходного файла (/F)
Параметры компилятора MSVC
Синтаксис командной строки компилятора MSVC
Указание пути