/internalPartition

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

構文

/internalPartition filename

解説

次の例では、 /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 で明示的にファイルに適用するには、ソリューション エクスプローラーでファイルを選択します。 右クリックしてコンテキスト メニューを開き、 Properties を選択して [プロパティ ページ] ダイアログを開きます。

  2. Configuration ドロップダウンを All Configurations に設定します。 [ Platform ドロップダウンを All Platforms に設定します。

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

  4. ドロップダウン コントロールを使用して、 Compile As プロパティを Compile as C++ Module Internal Partition (/internalPartition)に変更します。 [OK] または [適用] を選択して、変更内容を保存します。

関連項目

C++ のモジュールの概要
コマンド ラインからの MSVC での C++ モジュールの使用
Visual Studio 2019 16.5 での MSVC での C++ モジュールの準拠の機能強化