3.1.1 Fonction omp_set_num_threads

La fonction d' omp_set_num_threads définit le nombre par défaut de threads à utiliser pour les zones parallèles suivantes qui ne spécifient pas de clause d' num_threads . Le format est comme suit :

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

La valeur de num_threads de paramètre doit être un entier positif. Son effet dépend au moment si le réglage dynamique du nombre de threads est activé. Pour un ensemble de règles sur l'interaction entre la fonction d' omp_set_num_threads et la modification dynamique des threads, consultez la section 2,3 à la page 8.

Cette fonction a les effets décrits ci-dessus en cas de appel d'une partie du programme où la fonction d' omp_in_parallel retourne zéro. Si elle est appelée dans une partie du programme où la fonction d' omp_in_parallel retourne une valeur différente de zéro, le comportement de cette fonction n'est pas défini.

Cet appel est prioritaire sur la variable d'environnement OMP_NUM_THREADS . La valeur par défaut du nombre de threads, qui peuvent être générés en appelant omp_set_num_threads ou en définissant la variable d'environnement OMP_NUM_THREADS , peut être substituée explicitement sur une directive unique de parallèle en spécifiant la clause d' num_threads .

Références croisées :

• la fonction d'omp_set_dynamic , consultez section 3.1.7 à la page 39.

• la fonction d'omp_get_dynamic , consultez section 3.1.8 à la page 40.

• la variable d'environnementOMP_NUM_THREADS , consultez section 4,2 à la page 48, et la section 2,3 à la page 8.

• la clause d'num_threads , consultez section 2,3 à la page 8