Share via


2.1 Directive Format

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The syntax of an OpenMP directive is formally specified by the grammar in Appendix C, and informally as follows:

#pragma omp directive-name  [clause[ [,] clause]...] new-line  

Each directive starts with #pragma omp, to reduce the potential for conflict with other (non-OpenMP or vendor extensions to OpenMP) pragma directives with the same names. The remainder of the directive follows the conventions of the C and C++ standards for compiler directives. In particular, white space can be used before and after the #, and sometimes white space must be used to separate the words in a directive. Preprocessing tokens following the #pragma omp are subject to macro replacement.

Directives are case-sensitive. The order in which clauses appear in directives is not significant. Clauses on directives may be repeated as needed, subject to the restrictions listed in the description of each clause. If variable-list appears in a clause, it must specify only variables. Only one directive-name can be specified per directive. For example, the following directive is not allowed:

/* ERROR - multiple directive names not allowed */  
#pragma omp parallel barrier  

An OpenMP directive applies to at most one succeeding statement, which must be a structured block.