Syntax
#include <dlfcn.h> |
char *dlerror(void); |
The function __dlerror_ascii() with the same parameters must be used for the call in an ASCII environment.
Description
dlerror() returns a null-terminated character string (with no trailing newline) that describes the last error that occurred during dynamic linking processing. If no dynamic linking errors have occurred since the last invocation of dlerror(), dlerror() returns NULL. Thus, invoking dlerror() a second time, immediately following a prior invocation, will result in NULL being returned.
Return value
If successful, dlerror() returns a null-terminated character string. Otherwise, NULL is returned.
The errno variable is not set.
Application usage
The messages returned by dlerror() may reside in a static buffer that is overwritten on each call to dlerror(). Application code should not write to this buffer. Programs wishing to preserve an error message should make their own copies of that message.
See also
dlclose(), dlopen(), dlsym()