Description
The preprocessing directives defined by the C99 specification are supported.
The #pragma directive is described as:
-
#pragma pp-tokensopt new-line
A #pragma directive where the preprocessing token OPENCL
(used instead
of STDC
) does not immediately follow #pragma in the directive (prior to
any macro replacement) causes the implementation to behave in an
implementation-defined manner.
The behavior might cause translation to fail or cause the translator or the
resulting program to behave in a non-conforming manner.
Any such #pragma that is not recognized by the implementation is ignored.
If the preprocessing token OPENCL
does immediately follow #pragma in the
directive (prior to any macro replacement), then no macro replacement is
performed on the directive, and the directive shall have one of the
following forms whose meanings are described elsewhere:
// on-off-switch is one of ON, OFF, or DEFAULT
#pragma OPENCL FP_CONTRACT on-off-switch
#pragma OPENCL EXTENSION extensionname : behavior
#pragma OPENCL EXTENSION all : behavior
The following predefined macro names are available.
__FILE__
-
The presumed name of the current source file (a character string literal).
__LINE__
-
The presumed line number (within the current source file) of the current source line (an integer constant).
__OPENCL_VERSION__
-
For OpenCL devices with OpenCL version less than or equal to OpenCL 2.0, substitutes an integer value reflecting the OpenCL version supported by the device. This predefined macro is deprecated by OpenCL 2.1. For OpenCL devices with OpenCL version greater than OpenCL 2.0, it must be defined but may substitute any implementation-defined integer value greater than 200, reflecting OpenCL 2.0. [1]
CL_VERSION_1_0
-
Substitutes the integer 100 reflecting the OpenCL 1.0 version. Requires support for OpenCL C 1.1 or newer.
CL_VERSION_1_1
-
Substitutes the integer 110 reflecting the OpenCL 1.1 version. Requires support for OpenCL C 1.1 or newer.
CL_VERSION_1_2
-
Substitutes the integer 120 reflecting the OpenCL 1.2 version. Requires support for OpenCL C 1.2 or newer.
CL_VERSION_2_0
-
Substitutes the integer 200 reflecting the OpenCL 2.0 version. Requires support for OpenCL C 2.0 or newer.
CL_VERSION_3_0
-
Substitutes the integer 300 reflecting the OpenCL 3.0 version. Requires support for OpenCL C 3.0 or newer.
__OPENCL_C_VERSION__
-
Substitutes an integer reflecting the OpenCL C version specified by the
-cl-std
build option (see OpenCL Specification) to clBuildProgram or clCompileProgram. If the-cl-std
build option is not specified, the highest OpenCL C 1.x language version supported by each device is used as the version of OpenCL C when compiling the program for each device. Requires support for OpenCL C 1.2 or newer. __ROUNDING_MODE__
-
Used to determine the current rounding mode and is set to rte. Only affects the rounding mode of conversions to a float type. Deprecated by OpenCL C 1.1, along with the
cl_khr_
extension.select_ fprounding_ mode __ENDIAN_LITTLE__
-
Used to determine if the OpenCL device is a little endian architecture or a big endian architecture (an integer constant of 1 if device is little endian and is undefined otherwise). Also refer to the value of the
CL_DEVICE_
device query.ENDIAN_ LITTLE __kernel_exec(X, typen)
(andkernel_exec(X, typen)
)-
is defined as:
__kernel __attribute__((work_group_size_hint(X, 1, 1))) \
__attribute__((vec_type_hint(typen)))
__IMAGE_SUPPORT__
-
Used to determine if the OpenCL device supports images. This is an integer constant of 1 if images are supported and is undefined otherwise. Also refer to the value of the
CL_DEVICE_
device query and theIMAGE_ SUPPORT __opencl_c_
feature.images __FAST_RELAXED_MATH__
-
Used to determine if the
-cl-fast-relaxed-math
optimization option is specified in build options given to clBuildProgram or clCompileProgram. This is an integer constant of 1 if the-cl-fast-relaxed-math
build option is specified and is undefined otherwise.
The NULL
macro expands to a null pointer constant.
An integer constant expression with the value 0, or such an expression cast
to type void *
is called a null pointer constant.
Requires support for OpenCL C 2.0 or newer.
The macro names defined by the C99 specification but not currently supported by OpenCL are reserved for future use.
The predefined identifier __func__
is available.
Requires support for OpenCL C 1.2 or newer.
In OpenCL C 3.0 or newer there are a number of optional predefined macros indicating optional language features. Such macros are listed in the optional features in OpenCL C 3.0 table.
Document Notes
For more information, see the OpenCL C Specification
This page is extracted from the OpenCL C Specification. Fixes and changes should be made to the Specification, not directly.