3.1.1 omp_set_num_threads 函式

omp_set_num_threads函式會設定預設的執行緒數目来用於後續的平行區域未指定num_threads子句。 格式如下：

#include <omp.h>
void omp_set_num_threads(int num_threads);

參數值 num_threads 必須是正整數。 其效果，取決於是否啟用動態調整執行緒的數目。 為一組完整的規則之間互動之相關omp_set_num_threads函式，並動態調整執行緒，在 8] 頁面上，請參閱 2.3 節。

這個函式具有前文所述，從程式的一部分呼叫時的效果， omp_in_parallel函式會傳回零。 如果從程式的一部分呼叫， omp_in_parallel函數會傳回非零值，這個函式的行為是未定義。

這個呼叫的優先順序必高於OMP_NUM_THREADS環境變數。 預設值，可能會藉由呼叫建立的執行緒數目的omp_set_num_threads或藉由設定OMP_NUM_THREADS環境變數，可明確地覆寫單一平行指示詞指定num_threads子句。

交互參照：

• omp_set_dynamic函式，請參閱一節 3.1.7 在 39] 頁面上。

• omp_get_dynamic函式，請參閱一節 3.1.8 在 40] 頁面上。

• OMP_NUM_THREADS環境變數，請參閱一節 4.2 頁面 48，以及在頁面上 8 2.3 節。

• num_threads子句中，請參閱 2.3 節在頁面上 8