/internalPartition

/internalPartition コンパイラ オプションを使用して、入力ファイルを内部パーティションユニットとして扱います。これは、モジュールの外部インターフェイスに寄与しないモジュール パーティション実装ユニットです。

Syntax

/internalPartition filename

Remarks

次の例では、 /internalPartition オプションを使用する方法を示します。

ソース ファイル m-internals.cpp:

// m-internals.cpp
module m:internals;

void internalFunc() {} // cannot have `export` since this is an internal partition

ソース ファイル m.ixx:

// m.ixx
export module m;
import :internals; // Cannot export this partition.

export
void wrapper() { internalFunc(); }

このインターフェイスをコンパイルするには:

cl /std:c++latest /internalPartition /c m-internals.cpp

このオプションは、 /interface コンパイラ オプションでは使用できません。

/internalPartition は、Visual Studio 2019 バージョン 16.10 以降で使用できます。
/internalPartition には /std:c++20 以降が必要です。

Visual Studio 開発環境でこのコンパイラ オプションを設定するには

通常、パーティション ファイルに別の拡張機能を使用しない限り、Visual Studio開発環境ではこのオプションを設定しないでください。 既定では、ビルド システムは、 .ixx 拡張子を持つファイルにこのオプションを適用します。

  1. オプションを IDE で明示的にファイルに適用するには、ソリューション エクスプローラーでファイルを選択します。 右クリックしてコンテキスト メニューを開き、[ プロパティ ] を選択して [プロパティ ページ] ダイアログを開きます。

  2. [ 構成 ] ドロップダウンを [すべての構成] に設定します。 [ プラットフォーム ] ドロップダウンを [すべてのプラットフォーム] に設定します。

  3. 構成プロパティ>C/C++>Advanced プロパティ ページを開きます。

  4. ドロップダウン コントロールを使用して、C++ モジュール内部パーティション (/internalPartition) としてコンパイルするように Compile As プロパティを変更します。 [OK] または [適用] を選択して、変更内容を保存します。

こちらも参照ください

C++ のモジュールの概要
コマンド ラインからの MSVC での C++ モジュールの使用
C++ モジュールは、Visual Studio 2019 16.5