/headerUnit (Gunakan unit header IFC)

Mengimpor unit header. Memberi tahu pengkompilasi tempat menemukan .ifc file (representasi biner unit header) untuk header yang ditentukan.

Sintaks

/headerUnit header-filename=ifc-filename
/headerUnit:quote header-filename=ifc-filename
/headerUnit:angle header-filename=ifc-filename

Argumen

header-filename
Selama import header-name; pengkompilasi menyelesaikan header-name ke file pada disk. Gunakan header-filename untuk menentukan file tersebut. Setelah dicocokkan, pengkompilasi membuka IFC terkait yang dinamai oleh ifc-filename untuk impor.

ifc-filename
Nama file yang berisi informasi unit header yang dikompilasi. Untuk mengimpor lebih dari satu unit header, tambahkan opsi terpisah /headerUnit untuk setiap file.

Keterangan

Opsi /headerUnit pengkompilasi memerlukan atau yang lebih /std:c++20 baru.

Opsi /headerUnit pengkompilasi tersedia di Visual Studio 2019 versi 16.10 atau yang lebih baru.

Ketika kompilator menemukan import "file"; atau import <file>; opsi pengkompilasi ini membantu pengkompilasi menemukan unit header yang dikompilasi (.ifc) untuk file header yang ditentukan. Jalur ke file ini dapat diekspresikan dengan cara berikut:

• /headerUnit mencari unit header yang dikompilasi di direktori saat ini, atau di lokasi yang ditentukan oleh ifc-filename.

• /headerUnit:quote mencari file unit header yang dikompilasi menggunakan aturan yang sama dengan #include "file".

• /headerUnit:angle mencari file unit header yang dikompilasi menggunakan aturan yang sama dengan #include <file>.

Pengkompilasi tidak dapat memetakan satu header-name ke beberapa .ifc file. Anda dapat memetakan beberapa header-name argumen ke satu .ifc. Konten .ifc diimpor seolah-olah itu hanya header yang ditentukan oleh header-name.

Pengkompilasi secara implisit mengaktifkan praproscessor baru saat opsi ini digunakan. Jika ada bentuk /headerUnit yang ditentukan pada baris perintah, maka /Zc:preprocessor ditambahkan ke baris perintah oleh pengkompilasi. Untuk menolak implisit /Zc:preprocessor, tentukan: /Zc:preprocessor-

Jika Anda menonaktifkan pra-prosesor baru, tetapi file yang Anda kompilasi mengimpor unit header, pengkompilasi akan melaporkan kesalahan.

Contoh

Mengingat proyek yang mereferensikan dua file header dan unit headernya seperti yang tercantum dalam tabel ini:

File header	File IFC
C:\utils\util.h	C:\util.h.ifc
C:\app\app.h	C:\app\app.h.ifc

Opsi pengkompilasi untuk mereferensikan unit header untuk file header tertentu ini akan terlihat seperti ini:

cl ... /std:c++latest /headerUnit C:\utils\util.h=C:\util.h.ifc /headerUnit:quote app.h=app.h.ifc

Untuk mengatur opsi pengkompilasi ini di lingkungan pengembangan Visual Studio

Anda biasanya tidak boleh mengatur ini di lingkungan pengembangan Visual Studio. Ini diatur oleh sistem build.

Lihat juga

/exportHeader (Buat unit header)
/headerName (Buat unit header dari header yang ditentukan)
/reference (Gunakan modul bernama IFC)
/translateInclude (Terjemahkan termasuk arahan ke dalam arahan impor)