assert() are not available in OpenCL. Here an implementation similar to the classic C implementation. A difference is that instead to exit when an assertion failed a message is printed (if at least OpenCL 1.2) and the first assertion (or the last) is transmitted to the host program (see examples of use with C/C++, Java, Scala and Python).

There are also some PRINT() macros to use printf() function when it is available and that do nothing if not.

Main absolute links:

assertOpenCL library files:

Example of use:

OpenCL kernel: examples/kernel/example.cl

Examples of host program:

C host: examples/C/example.c
C++ host: examples/Cpp/example.cpp
Java (at least since Java 1.8) host (with JOCL): examples/Java/Example.java
Scala host (with JOCL): Example.scala (generated with Scaladoc)
Python (2 and 3) host (with PyOpenCL): examples/Python/example.py

Additional tools:

Print information on OpenCL platforms and devices: tools/opencl_infos.py
Parse cl.h to extract list of error codes and names: tools/opencl_parse_error_codes.py
List of all error codes and names extracted from cl.h: examples/C/opencl_errors_map.h

Warning: Be careful with *_r() and *_r0() versions of assert*() when you have some barriers in your kernel. If at least one work-item reach the barrier, then all barriers have to reach it. See the official documentation of OpenCL to understand the constraints: barrier.

License: GPLv3

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Olivier Pirson
www.opimedia.be
olivier.pirson.opi@gmail.com