Macros#
Version Macros#
Use these macros to get the current version of oneAPI DPC++ Library (oneDPL).
Macro |
Description |
---|---|
|
The version of the specification that the implementation is compliant with. |
|
A decimal number for the major version of the library. |
|
A decimal number for the minor version. |
|
A decimal number for the patch. |
|
The version of LLVM PSTL code used in oneDPL. The value is a decimal numeral of the form |
|
|
|
|
|
|
Feature Macros#
Use these macros to test presence of specific oneDPL functionality.
Macro |
Macro values and the functionality |
---|---|
|
Pseudo-random number generators and distributions.
|
|
Parallel range algorithms.
|
Additional Macros#
Use these macros to control aspects of oneDPL usage. You can set them in your program code before including oneDPL headers.
Macro |
Description |
---|---|
|
This macro enables the use of Using this macro may have the same effect on the implementation of parallel algorithms in the C++ standard libraries of GCC and LLVM. |
|
This macro enables Parallel STL to emit compile-time messages, such as warnings about an algorithm not supporting a certain execution policy. When set to 1, the macro allows the implementation to emit usage warnings. When the macro is not defined (by default) or evaluates to zero, usage warnings are disabled. Using this macro may have the same effect on the implementation of parallel algorithms in the C++ standard libraries of GCC and LLVM. |
|
This macro controls the use of oneAPI Threading Building Blocks (oneTBB) or Intel® Threading Building Blocks (Intel® TBB) for parallel
execution policies ( When the macro evaluates to a non-zero value, or when it is not defined (by default) and no other parallel backends are explicitly chosen, algorithms with parallel policies are executed using the oneTBB or Intel® TBB library. Setting the macro to 0 disables use of TBB API for parallel execution and is recommended for code that should not depend on the presence of the oneTBB or Intel® TBB library. If all parallel backends are disabled by setting respective macros to 0, algorithms with parallel policies are executed sequentially by the calling thread. |
|
This macro controls the use of OpenMP* for parallel execution policies ( When the macro evaluates to a non-zero value, algorithms with parallel policies are executed
using OpenMP unless the TBB backend is explicitly enabled (that is, the TBB backend takes
precedence over the OpenMP backend).
When the macro is not defined (by default) and no other parallel backends are chosen,
a dedicated compiler option to enable OpenMP (such as If all parallel backends are disabled by setting respective macros to 0, algorithms with parallel policies are executed sequentially by the calling thread. |
|
This macro enables the use of device execution policies. When the macro is not defined (default), device policies are enabled only if SYCL support can be detected; otherwise, they are disabled. If the macro is set to a non-zero value, device policies are enabled unconditionally. Setting the macro to 0 disables device policies. When device policies are disabled, no SYCL dependency is introduced, and their usage will lead to compilation errors. |
|
This macro enables the use of predefined device policy objects,
such as |
|
This macro allows waiting for completion of certain algorithms executed with device policies to be deferred. (Disabled by default.) When the macro evaluates to non-zero, a call to a oneDPL algorithm with a device policy might return before the computation completes on the device. Warning Before accessing data produced or modified by the call, waiting for completion of all tasks in the corresponding SYCL queue is required; otherwise, the program behavior is undefined. |
|
Use this macro to build your code containing oneDPL parallel algorithms for FPGA devices. (Disabled by default.) |
|
Use this macro to build your code containing Parallel STL algorithms for FPGA emulation device. (Disabled by default.) Note Define |