Negate a DBMONEY value.
RETCODE dbmnyminus(dbproc, src, dest) DBPROCESS *dbproc; DBMONEY *src; DBMONEY *dest;
A pointer to the DBPROCESS structure that provides the connection for a particular front-end/server process. It contains all the information that DB-Library uses to manage communications and data between the front end and the server.
This parameter may be NULL. The DBPROCESS is used as a parameter to an application’s error handler. It also contains information on what language to print error messages in. If a DBPROCESS is not supplied, the default national language is used.
A pointer to a DBMONEY value.
A pointer to a DBMONEY variable to hold the result of the negation.
SUCCEED or FAIL.
dbmnyminus returns FAIL in case of overflow, or if src or dest is NULL.
dbmnyminus negates the src DBMONEY value and places the result into *dest.
In case of overflow, dbmnyminus returns FAIL. *dest is undefined in this case. An attempt to negate the maximum negative DBMONEY value will result in overflow.
The range of legal DBMONEY values is between +/-$922,337,203,685,477.5808. DBMONEY values have a precision of one ten-thousandth of a dollar.