The ifx_dececvt() and ifx_decfcvt() function

Syntax

mint ifx_dececvt(np, ndigit, decpt, sign, decstr, decstrlen)
   register dec_t *np;
   register mint ndigit;
   mint *decpt;
   mint *sign;
   char *decstr;
   mint decstrlen;

mint ifx_decfcvt(np, ndigit, decpt, sign, decstr, decstrlen)
   register dec_t *np;
   register mint ndigit;
   mint *decpt;
   mint *sign;
   char *decstr;
   mint decstrlen;

np

A pointer to a decimal structure that contains the decimal value to be converted.

ndigit

The length of the ASCII string for ifx_dececvt(). It is the number of digits to the right of the decimal point for ifx_decfcvt().

decpt

A pointer to an integer that is the position of the decimal point relative to the beginning of the string. A negative or zero value for *decpt means that the position is located to the left of the returned digits.

sign

A pointer to the sign of the result. If the sign of the result is negative, *sign is nonzero; otherwise, it is zero.

decstr

The user-defined buffer where the function returns the converted decimal value.

decstrlen

The length, in bytes, of the decstr buffer that the user defines.

Usage

The ifx_dececvt() function is the thread-safe version of the dececvt() function. The ifx_decfcvt() function is the thread-safe version of decfcvt() function. Each function returns a character string that cannot be overwritten when two threads simultaneously call the function. For information about how to use dececvt() and decfcvt(), see The dececvt() and decfcvt() functions.

Return codes

0

The conversion was successful.

<0

The conversion was not successful.

-1273

Output buffer is null or too small to hold the result.