Functions
RaimaDB Return Code APIs
RaimaDB C/C++ API Reference
Collaboration diagram for RaimaDB Return Code APIs:

Functions
RDM_RETCODE rdm_retcodeGetCode (const char *retCodeName)
Get the numeric RaimaDB status code for a literal status name. More...
const char * rdm_retcodeGetDescription (RDM_RETCODE retcode)
Invoke RaimaDB error handler. More...
const char * rdm_retcodeGetName (RDM_RETCODE retcode)
Get the mnemonic name for an error or status code. More...

Detailed Description

The RaimaDB return code API. The functions here are located in RaimaDB DB Engine Library. Linker option:

    -lrdmrdm

Function Documentation

rdm_retcodeGetCode()

RDM_RETCODE rdm_retcodeGetCode ( const char * retCodeName )

#include <rdmretcodeapi.h>

Get the numeric RaimaDB status code for a literal status name.

This function returns the RaimaDB status code associated with the specified mnemonic status name.

Locking Requirements
None
Returns
  • An RDM_RETCODE value that corresponds to the mnemonic status name
  • eSYS_BADERRCODE if an invalid mnemonic status name is given
See also
rdm_retcodeGetName

rdm_retcodeGetDescription()

const char* rdm_retcodeGetDescription ( RDM_RETCODE retcode )

#include <rdmretcodeapi.h>

Invoke RaimaDB error handler.

Returns
  • The status/error code description string
  • NULL if an invalid RDM_RETCODE value is given
See also
rdm_retcodeGetName
Parameters
[in] retcode Status or error code returned by a RaimaDB API function
Examples
core01Example_main.c, core15Example_main.c, core16Example_main.c, core17Example_main.c, core18Example_main.c, core19Example_main.c, core31Example_main.c, core32Example_main.c, core33Example_main.c, core35Example_main.c, core36Example_main.c, core37Example_main.c, core40Example_main.c, cpp50Example_main.cpp, cpp51example_main.cpp, cpp55Example_main.cpp, cpp70Example_main.cpp, learn/bookStore_client.c, learn/bookStore_embed.c, and learn/bookStore_vxWorks7.c.

rdm_retcodeGetName()

const char* rdm_retcodeGetName ( RDM_RETCODE retcode )

#include <rdmretcodeapi.h>

Get the mnemonic name for an error or status code.

This function returns the mnemonic name associated with the specified error or status code.

Locking Requirements
None
Returns
  • The status/error code mnemonic name string
  • NULL if an invalid RDM_RETCODE value is given
See also
rdm_retcodeGetDescription
Parameters
[in] retcode Status or error code returned by a RaimaDB API function
Examples
core01Example_main.c, core15Example_main.c, core16Example_main.c, core17Example_main.c, core18Example_main.c, core19Example_main.c, core31Example_main.c, core32Example_main.c, core33Example_main.c, core35Example_main.c, core36Example_main.c, core37Example_main.c, core40Example_main.c, cpp50Example_main.cpp, cpp51example_main.cpp, cpp55Example_main.cpp, cpp70Example_main.cpp, learn/bookStore_client.c, learn/bookStore_embed.c, and learn/bookStore_vxWorks7.c.