Bagikan melalui

/exportHeader (Buat unit header)

  • Artikel

Memberi tahu pengkompilasi untuk membuat unit header yang ditentukan oleh argumen input. Pengkompilasi menghasilkan unit header sebagai file IFC (.ifc).

Sintaks

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Argumen

Argumen ke /exportHeader adalah /headerName opsi baris perintah yang menentukan nama, header-name, dari file header yang akan diekspor.

Keterangan

/exportHeader tersedia mulai dari Visual Studio 2019 versi 16.10.

Opsi /exportHeader pengkompilasi mengharuskan /std:c++20 Anda mengaktifkan opsi pengkompilasi atau yang lebih baru (seperti /std:c++latest).

Satu /exportHeader opsi kompilator dapat menentukan argumen nama header sebanyak yang diperlukan build Anda. Anda tidak perlu menentukannya secara terpisah.

Pengkompilasi secara implisit mengaktifkan praproscessor baru saat opsi ini digunakan. Artinya, /Zc:preprocessor ditambahkan ke baris perintah oleh pengkompilasi jika ada bentuk yang /exportHeader digunakan pada baris perintah. Untuk menolak implisit /Zc:preprocessor, gunakan: /Zc:preprocessor-

Secara default, pengkompilasi tidak menghasilkan file objek saat unit header dikompilasi. Untuk menghasilkan file objek, tentukan /Fo opsi pengkompilasi. Untuk informasi selengkapnya, lihat /Fo (Nama File Objek).

Anda mungkin merasa berguna untuk menggunakan opsi /showResolvedHeaderpelengkap . Opsi /showResolvedHeader mencetak jalur absolut ke file yang header-name diselesaikan argumen.

/exportHeader dapat menangani beberapa input sekaligus, bahkan di bawah /MP. Kami sarankan Anda menggunakan /ifcOutput <directory> untuk membuat file terpisah .ifc untuk setiap kompilasi.

Contoh

Untuk membangun unit header seperti <vector> mungkin terlihat seperti:

cl . . . /std:c++latest /exportHeader /headerName:angle vector

Membangun header proyek lokal seperti "utils/util.h" mungkin terlihat seperti:

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

Untuk mengatur opsi pengkompilasi ini di lingkungan pengembangan Visual Studio

Anda biasanya tidak boleh mengatur opsi ini di lingkungan pengembangan Visual Studio kecuali Anda menggunakan ekstensi yang berbeda untuk file header Anda. Secara default, sistem build menerapkan opsi ini untuk mengkompilasi file yang memiliki .h ekstensi, atau tanpa ekstensi.

  1. Untuk menerapkan opsi ke /exportHeader file secara eksplisit di IDE, pilih file di Penjelajah Solusi. Klik kanan untuk membuka menu konteks dan pilih Properti untuk membuka dialog Halaman Properti.

  2. Atur menu dropdown Konfigurasi ke Semua Konfigurasi. Atur dropdown Platform ke Semua Platform.

  3. Buka halaman properti Properti>Konfigurasi C/C++>Tingkat Lanjut.

  4. Gunakan kontrol dropdown untuk memodifikasi properti Compile As untuk Mengkompilasi sebagai C++ Header Unit (/exportHeader). Pilih OK atau Terapkan untuk menyimpan perubahan Anda.

Lihat juga

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