You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Most LMX API functions return status information LMX_STATUS that indicates the success or failure of the requested operation. You should review this information to make problem identification easier.

The following code is an example of an error handler that writes errors to a file. In addition, it is used for all code snippets provided in this documentation in order to shorten and secure those examples. Please, insure this function is defined if you want to compile snippets as provided.

LMX_HANDLE h;

void exit_on_error(LMX_STATUS s) {
  if (s != LMX_SUCCESS) {
    if (h != NULL) {
      fprintf(stderr, "%s\n", LMX_GetErrorMessage(h));
      LMX_Free(h); // Release memory allocated by LM-X 
    } else {
      fprintf(stderr, "%s\n", LMX_GetErrorMessageSimple(s));
    }
    fflush(stderr);
    exit(1);
  }

On failure, when a function returns the status code other than LMX_SUCCESS, the above example will display the corresponding error and its context (see LMX_GetErrorMessage). If the handler is null, it will only display the error name (see LMX_GetErrorMessageSimple).

  • No labels