You want to handle fatal errors (assertions) yourself rather than have the library call abort().

Step-by-step guide

When there is an assertion failure, the library first checks whether the user has defined his/her own assertion handling mechanism. If not, it prints a message and calls abort. This is the default behaviour. But you can override this in the following way using the C API:

  1. Define a function with the following signature:

    typedef void (*codes_assertion_failed_proc)(const char* message);
  2. Then point the library to your function:

  3. Now the library will call the chosen function (which for example could do nothing or throw a C++ exception) instead of the abort.
  4. To restore the default behaviour, call



static void my_assertion_proc(const char* message)
    printf("It's OK. I caught the assertion: %s\n", message);
    // Do something like throw MyProj::FatalException(message);

int main(int argc, char **argv)

    // All asserts in the ecCodes library will now be caught

    // Now restore default behaviour

    return 0;