インテルの valarray の使用

インテルの valarray を使用すると、並列処理に大きな配列を宣言することができます。強化された valarray の実装は、インテル® インテグレーテッド・パフォーマンス・プリミティブ (インテル® IPP) の IPP ライブラリーを呼び出します。

これは C++ 固有のコンテンツです。DPC++ には適用されません。

ソースコードでの valarray の使用

valarray をソースコードで使用するには、valarray ヘッダーファイル <valarray> をインクルードします。<valarray> ヘッダーファイルは <installdir>/perf_header のパスにあります。

次のコードは、インテルの valarray を使った valarray 加算 (+) の例を示しています。

#include <valarray>
void test( )
{
	std::valarray<float> vi(N), va(N);
	…
	vi = vi + va;  // 配列の加算
	…
}

すべてのプロセッサー固有のライブラリー・コードを含むスタティック・マージ・ライブラリーを使用するには、インテル® IPP 呼び出しの前に、ippStaticInit 関数を呼び出す必要があります。これにより、ランタイム時にインテル® プロセッサーでは正しいバージョンのライブラリー・コードへ、互換プロセッサーでは汎用バージョンのライブラリー・コードへ自動的にディスパッチされます。最初に ippStaticInit を呼び出さないと、マージ・ライブラリーは標準のライブラリー・コードを使用します。ダイナミック・ライブラリーを使用する場合、ippStaticInit を呼び出す必要はありません。

valarray ソースコードのコンパイル

valarray を含むソースコードをコンパイルする場合、コンパイラー・オプション /Quse-intel-optimized-headers (Windows*) または -use-intel-optimized-headers (Linux* および macOS*) を使用して、必要な valarray ヘッダーファイルと必要なすべて IPP ライブラリー・ファイルをインクルードします。

次の例は、インテルの valarray 代替ヘッダーファイルをインクルードし、インテル® IPP とリンクするための、プログラムのコンパイルとリンク方法を示します。詳細は、インテル® IPP のドキュメントを参照してください。

次の例の "マージ" ライブラリーでは、すべてのプロセッサー固有のライブラリー・コードを含むスタティック・ライブラリーを使用しています。

Windows* の例

次のコマンドラインは、IA-32 アーキテクチャー・ベースの Windows* システムで、1 回のコンパイルを実行します。

icx /Quse-intel-optimized-headers source.cpp

次のコマンドラインは、IA-32 アーキテクチャー・ベースの Windows* システムで、コンパイルとリンクを別々に実行します。

DLL (ダイナミック):

icx /Quse-intel-optimized-headers /c source.cpp
icx source.obj /Quse-intel-optimized-headers

マージ (スタティック):

icx /Quse-intel-optimized-headers /Qipp-link:static /c source.cpp
icx source.obj /Quse-intel-optimized-headers /Qipp-link:static 

Linux* の例

次のコマンドラインは、インテル® 64 アーキテクチャー・ベースの Linux* システムで、1 回のコンパイルを実行します。

icpx -use-intel-optimized-headers source.cpp

次のコマンドラインは、インテル® 64 アーキテクチャー・ベースの Linux* システムで、コンパイルとリンクを別々に実行します。

so (ダイナミック):

icpx -use-intel-optimized-headers -c source.cpp
icpx source.o -use-intel-optimized-headers -shared-intel

マージ (スタティック):

icpx -use-intel-optimized-headers -c source.cpp
icpx source.o -use-intel-optimized-headers

性能は、使用法、構成、およびその他の要因によって異なります。詳細については、www.Intel.com/PerformanceIndex (英語) を参照してください。

注意事項の改訂 #20201201