NAG CL Interface
x06abc (get_​num_​threads)

x06abc returns the number of OpenMP threads in the current team.

The function may be called by the names: x06abc or nag_omp_get_num_threads.

x06abc, for multithreaded implementations, returns the number of OpenMP threads in the current team. If the number of threads is deemed critical then you are advised to use x06abc to retrieve this value as it may be less than that requested with either a call to x06aac, your OMP_NUM_THREADS environment variable value or by using a num_threads clause on an OpenMP parallel directive.

The number of threads actually in use in a parallel region is dependent on several factors. Please refer to Section 4 for a full description of how the number of threads is chosen for a particular parallel region.

If this function is called from a sequential part of a multithreaded program then it will return the value $1$.

In serial implementations of the NAG Library this function will always return $1$. See the X06 Chapter Introduction for a discussion of the behaviour of these functions when called in serial.

Chapman B, Jost G and van der Pas R (2008) Using OpenMP Portable Shared Memory Parallel Programming The MIT Press

None.

None.

Not applicable.

Background information to multithreading can be found in the Multithreading documentation.

x06abc is not threaded in any implementation.

None.

See x06aac for a demonstration of how to use x06abc.