for (OpenMP)

並行領域内の for ループ内で行われる動作をスレッド間に分割します。

#pragma omp [parallel] for [clauses]
      for_statement

解説

指定項目

• clause (省略可能)
  0 個以上の句。for によってサポートされている句の一覧については、「解説」を参照してください。

• for_statement
  for ループ。for ループのユーザー コードでインデックスの変数を変更すると、未定義の動作になります。

解説

for ディレクティブは次の OpenMP 句をサポートします。

• firstprivate

• lastprivate

• nowait

• ordered

• private

• reduction

• schedule

parallel も指定する場合は、clause に、parallel ディレクティブまたは for ディレクティブで使用できる nowait 以外の任意の句を指定できます。

詳細については、「2.4.1 for のコンストラクト」を参照してください。

使用例

// omp_for.cpp
// compile with: /openmp 
#include <stdio.h>
#include <math.h>
#include <omp.h>

#define NUM_THREADS 4
#define NUM_START 1
#define NUM_END 10

int main() {
   int i, nRet = 0, nSum = 0, nStart = NUM_START, nEnd = NUM_END;
   int nThreads = 0, nTmp = nStart + nEnd;
   unsigned uTmp = (unsigned((abs(nStart - nEnd) + 1)) * 
                               unsigned(abs(nTmp))) / 2;
   int nSumCalc = uTmp;

   if (nTmp < 0)
      nSumCalc = -nSumCalc;

   omp_set_num_threads(NUM_THREADS);

   #pragma omp parallel default(none) private(i) shared(nSum, nThreads, nStart, nEnd)
   {
      #pragma omp master
      nThreads = omp_get_num_threads();

      #pragma omp for
      for (i=nStart; i<=nEnd; ++i) {
            #pragma omp atomic
            nSum += i;
      }
   }

   if  (nThreads == NUM_THREADS) {
      printf_s("%d OpenMP threads were used.\n", NUM_THREADS);
      nRet = 0;
   }
   else {
      printf_s("Expected %d OpenMP threads, but %d were used.\n",
               NUM_THREADS, nThreads);
      nRet = 1;
   }

   if (nSum != nSumCalc) {
      printf_s("The sum of %d through %d should be %d, "
               "but %d was reported!\n",
               NUM_START, NUM_END, nSumCalc, nSum);
      nRet = 1;
   }
   else
      printf_s("The sum of %d through %d is %d\n",
               NUM_START, NUM_END, nSum);
}

4 OpenMP threads were used.
The sum of 1 through 10 is 55

参照

概念

OpenMP ディレクティブ