/cgthreads (コード生成スレッド)

最適化とコード生成に使用するための cl.exe スレッドの数を設定します。

構文

/cgthreads1
/cgthreads2
/cgthreads3
/cgthreads4
/cgthreads5
/cgthreads6
/cgthreads7
/cgthreads8

引数

cgthreadsN
cl.exe が使用できるスレッドの最大数。N は 1 から 8 までの数字です。

解説

cgthreads オプションを使うと、コンパイルの最適化およびコード生成のフェーズで cl.exe が並列で使用するスレッドの最大数を指定できます。 cgthreads と "数字" の引数の間にスペースを入れることはできません。 既定では、cl.exe は /cgthreads4 が指定されているかのように 4 つのスレッドを使用します。 より多くのプロセッサ コアを使用できる場合は、より大きい "数字" の値によってビルド時間を短縮できます。 このオプションは、/GL (プログラム全体の最適化) と組み合わせると特に便利です。

ビルドでは複数のレベルの並列化を指定できます。 msbuild.exe スイッチ /maxcpucount を使うと、並列で実行できる MSBuild プロセスの数を指定できます。 /MP (複数のプロセスを使用したビルド) コンパイラ フラグを使うと、ソース ファイルを同時にコンパイルする cl.exe プロセスの数を指定できます。 cgthreads オプションでは、それぞれの cl.exe プロセスが使用するスレッドの数を指定します。 プロセッサが同時に実行できるスレッドの数は、プロセッサ コアの数と同じです。 これらのオプションすべてに対して大きな値を同時に指定することは有益ではなく、逆効果になる場合もあります。 プロジェクトを並行してビルドする方法の詳細については、複数のプロジェクトを並行でビルドする方法に関する記事を参照してください。

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

  1. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、Visual Studio での C++ コンパイラとビルド プロパティの設定に関する記事を参照してください。

  2. [構成プロパティ]>[C/C++]>[コマンド ライン] プロパティ ページを選択します。

  3. [追加のオプション] プロパティを変更して cgthreadsN (N は 1 から 8 までの値) を含めた後、[OK] を選択します。

このコンパイラ オプションをコードから設定するには

関連項目

MSVC コンパイラ オプション
MSVC コンパイラのコマンド ライン構文