/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 olehifc-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)