| The DFPAL Library, version 2.20
© Copyright IBM Corporation, 2007. All rights reserved.
|[previous | contents | next]||[printer friendly]|
malloc()for the application memory allocation. Instead, such applications have their own memory management layer based on shared memory, for example. This function shall be called before
dfpalInit()to determine amount of memory needed by the DFPAL.
dfpalInit()before any of its service is accessed. The input
contextis pointer to allocated memory. This function either returns
DFPAL_ERR_NO_ERRORor an error code indicating error condition. List of possible errors and error codes can be found in
dfpalerr.h. For multi-threaded application, each thread using DFPAL service must initialize using this service. Additionally, application is responsible for making sure that memory passed as an argument is thread safe.
dfpalInit()reads environment variable
DFPAL_EXE_MODE. Possible values for this environment variable are
DNSW(force DFPAL to use decNumber software mode),
PPCHW(force DFPAL to use PowerPC hardware mode;
dfpalInit()will return error if no hardware support available), or
AUTO(auto detect). Default value, in absence of the environment variable or undefined value, is
dlopen()/dlsym(). Applications not using runtime linking and loading do not have to use this.
dfpalInit()call earlier. It takes a pointer to function performing memory de-allocation. Typically, memory de-allocation function is corresponding to one used to allocate memory for the
DNSW(decNumber Software) if DFPAL is using decNumber software implementation for the decimal floating point arithmetic. Returns
PPCHW(Power PC Hardware) if DFPAL is using hardware decimal floating point arithmetic.
dfpalGetError()after this function call will return “No error”.
dfpalGetError()but only returns DFPAL error code.
dfpalInit()on Unix platforms. On Windows platform, if DFPAL is integrated into some other container module, use that container module’s
DllMain()equivalent facility to call
DLL_PROCESS_ATTACHevent. Refer to How to compile DFPAL? for more details.
DFPAL is authored by Punit Shah (email@example.com).
Please send any corrections, comments or questions to firstname.lastname@example.org.
|This page was updated on 21 Dec 2007.|