Bagikan melalui

/headerName (Bangun unit header dari header yang ditentukan)

  • Artikel

Buat file header yang ditentukan ke dalam unit header (.ifc file).

Sintaks

/headerName:quote header-filename
/headerName:angle header-filename

Argumen

header-filename
Nama file header yang harus dikompilasi pengkompilasi ke dalam unit header (.ifc file).

Keterangan

Opsi /headerName:quote pengkompilasi dan /headerName:angle tersedia mulai di Visual Studio 2019 versi 16.10.

Opsi /headerName pengkompilasi, dalam semua formulirnya, memerlukan /std:c++20 opsi pengkompilasi atau yang lebih baru (seperti /std:c++latest).
Jika Anda menentukan /headerName opsi, Anda juga harus menentukan /exportHeader.

  • /headerName:quote mencari header-filename menggunakan aturan yang sama seperti #include "header-filename" dan membangunnya sebagai unit header (.ifc file).
  • /headerName:angle mencari header-filename menggunakan aturan yang sama seperti #include <header-filename> dan membangunnya sebagai unit header (.ifc file).

Untuk informasi selengkapnya tentang aturan pencarian jalur untuk file yang disertakan dalam tanda kutip atau tanda kurung sudut, lihat #include direktif.

Contoh

Mengingat proyek yang mereferensikan file header yang didefinisikannya disebut m.h, opsi pengkompilasi untuk mengkompilasinya ke dalam unit header terlihat mirip dengan contoh ini:

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

Opsi /headerName:quote dan /headerName:angle bertindak seperti bendera dan tidak memerlukan argumen. Contoh berikut valid:

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Anda dapat menentukan beberapa /headerName opsi pada baris perintah yang sama. Setiap argumen setelah /headerName opsi diproses dengan yang ditentukan termasuk aturan pencarian file untuk tanda kutip atau tanda kurung sudut hingga opsi berikutnya /headerName . Contoh berikut memproses semua header sebagai dua contoh baris perintah sebelumnya dengan cara yang sama seperti sebelumnya. Ini mencari header menggunakan aturan pencarian yang diterapkan seolah-olah mereka telah ditentukan sebagai: #include <vector>, , #include <iostream>, #include <algorithm>, #include "my-utilties.h", dan #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

Untuk mengatur opsi pengkompilasi ini di lingkungan pengembangan Visual Studio

Catatan

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

  1. Buka kotak dialog Halaman Properti proyek. Untuk detailnya, lihat Mengatur pengkompilasi C++ dan membuat properti di Visual Studio.

  2. Atur menu drop-down Konfigurasi ke Semua Konfigurasi. Atur menu drop-down Platform ke Semua Platform.

  3. Pilih halaman properti Properti>Konfigurasi C/C++>Baris Perintah.

  4. Ubah properti Opsi Tambahan untuk menambahkan /headerName:quote opsi atau /headerName:angle dan nama file header tempat opsi diterapkan. Lalu, pilih OK atau Terapkan untuk menyimpan perubahan Anda.

Lihat juga

/exportHeader (Buat unit header)
/headerUnit (Gunakan unit header IFC)
/reference (Gunakan modul bernama IFC)
/translateInclude (Terjemahkan termasuk arahan ke dalam arahan impor)