NAG C Library Function Document

nag_omp_get_nested (x06ahc)

1
Purpose

nag_omp_get_nested (x06ahc) returns 1 if nested OpenMP parallelism has been enabled, and 0 otherwise.

2
Specification

#include <nag.h>
#include <nagx06.h>
Integer  nag_omp_get_nested ()

3
Description

nag_omp_get_nested (x06ahc), for multi-threaded implementations, tests whether the nesting of OpenMP parallel regions has been enabled as if with a call to nag_omp_set_nested (x06agc). The return value will be 1 if nesting is enabled or 0 if it is disabled.
In serial implementations of the NAG C Library nag_omp_get_nested (x06ahc) will always return 0. See the x06 Chapter Introduction for a discussion of the behaviour of these functions when called in serial.

4
References

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

5
Arguments

None.

6
Error Indicators and Warnings

None.

7
Accuracy

Not applicable.

8
Parallelism and Performance

nag_omp_get_nested (x06ahc) is not threaded in any implementation.

9
Further Comments

None.

10
Example

See Section 10 in nag_omp_set_nested (x06agc) for a demonstration of how to use nag_omp_get_nested (x06ahc).