/FA, /Fa (Plik listy)

  • Artykuł

Tworzy plik listy zawierający kod asemblera.

Składnia

/FA[c][s][u]
/FaNazwa_ścieżki

Uwagi

Opcja /FA kompilatora generuje plik z listą asemblera dla każdej jednostki tłumaczenia w kompilacji, która zazwyczaj odpowiada plikowi źródłowemu języka C lub C++. Domyślnie tylko asembler jest dołączany do pliku listy, który jest zakodowany jako ANSI. Opcjonalne cargumenty /FA , si u do kontrolowania, czy kod maszyny lub kod źródłowy są wyjściowe razem z listą asemblera i czy lista jest zakodowana jako UTF-8.

Domyślnie każdy plik listy pobiera taką samą nazwę podstawową .asm jak plik źródłowy i ma rozszerzenie. Gdy kod maszyny jest dołączany przy użyciu c opcji, plik listy ma .cod rozszerzenie. Możesz zmienić nazwę i rozszerzenie pliku listy oraz katalog, w którym został utworzony, przy użyciu /Fa opcji .

/FA Argumenty

Brak
Na liście znajduje się tylko język asemblera.

c
Opcjonalny. Zawiera kod maszyny na liście.

s
Opcjonalny. Zawiera kod źródłowy na liście.

u
Opcjonalny. Koduje plik listy w formacie UTF-8 i zawiera znacznik kolejności bajtów. Domyślnie plik jest zakodowany jako ANSI. Użyj u polecenia , aby utworzyć plik listy, który jest poprawnie wyświetlany w dowolnym systemie lub jeśli używasz plików kodu źródłowego Unicode jako danych wejściowych kompilatora.

s Jeśli parametr i u są określone, a plik kodu źródłowego używa kodowania Unicode innego niż UTF-8, wiersze kodu w .asm pliku mogą nie być wyświetlane poprawnie.

Argument /Fa

Brak
Jeden plik source.asm jest tworzony dla każdego pliku kodu źródłowego w kompilacji.

Pod nazwą
Kompilator umieszcza plik listy o nazwie nazwa_pliku.asm w bieżącym katalogu. Ten formularz argumentu jest prawidłowy tylko podczas kompilowania pojedynczego pliku kodu źródłowego.

nazwa pliku.extension
Kompilator umieszcza plik listy o nazwie nazwa_pliku.extension w bieżącym katalogu. Ten formularz argumentu jest prawidłowy tylko podczas kompilowania pojedynczego pliku kodu źródłowego.

Katalogu\
Kompilator tworzy jeden plik source_file.asm dla każdego pliku kodu źródłowego w kompilacji. Znajduje się on w określonym katalogu. Wymagany jest końcowy ukośnik odwrotny. Dozwolone są tylko ścieżki na bieżącym dysku.

nazwa pliku katalogu\
Plik listy o nazwie nazwa_pliku.asm jest umieszczany w określonym katalogu. Ten formularz argumentu jest prawidłowy tylko podczas kompilowania pojedynczego pliku kodu źródłowego.

nazwa pliku katalogu.extension\
Plik listy o nazwie nazwa_pliku.extension znajduje się w określonym katalogu. Ten formularz argumentu jest prawidłowy tylko podczas kompilowania pojedynczego pliku kodu źródłowego.

Aby ustawić tę opcję kompilatora w środowisku programowania Visual Studio

  1. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać szczegółowe informacje, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilowania w programie Visual Studio).

  2. Wybierz stronę właściwości Właściwości>konfiguracji C/C++>Output Files.

  3. Zmodyfikuj właściwość Output asemblera, aby ustawić opcje /FAc i /FAs dla asemblera, maszyny i kodu źródłowego. Zmodyfikuj właściwość Use Unicode For Assembler Listing (Użyj formatu Unicode for Assembler Listing ), aby ustawić /FAu opcję dla danych wyjściowych ANSI lub UTF-8. Zmodyfikuj lokalizację listy usługi ASM, aby ustawić /Fa opcję wyświetlania listy nazw plików i lokalizacji.

Ustawienie zarówno danych wyjściowych asemblera, jak i użycie formatu Unicode dla właściwości list asemblera może spowodować ostrzeżenie wiersza polecenia D9025. Aby połączyć te opcje w środowisku IDE, zamiast tego użyj pola Opcje dodatkowe na stronie właściwości Wiersza polecenia.

Aby programowo ustawić tę opcję kompilatora

Przykład

Poniższy wiersz polecenia tworzy połączone źródło i listę kodu maszynowego o nazwie HELLO.cod:

CL /FAcs HELLO.CPP

Zobacz też

Plik wyjściowy (/F), opcje
Opcje kompilatora MSVC
Składnia wiersza polecenia kompilatora MSVC
Określanie nazwy ścieżki