The mi_money_to_string() function

The mi_money_to_string() function creates a text (string) representation of a monetary value from the binary (internal) MONEY representation.

Syntax

mi_string *mi_money_to_string(money_data)
   mi_money *money_data;
money_data
A pointer to the internal MONEY representation of the monetary value.
Valid in client LIBMI application? Valid in user-defined routine?
Yes Yes

Usage

The mi_money_to_string() function converts the internal MONEY value that money_data contains into a monetary string. An internal MONEY value is the format that the database server uses to store a value in a MONEY column of the database.
Important: The mi_money_to_string() function replaces the mi_binary_to_money() function for internal MONEY-to-string conversion in DataBlade® API modules.

For GLS, the mi_money_to_string() function formats the monetary string in the monetary format of the current processing locale. For more information, see the Informix® GLS User's Guide.

For more information about how to convert internal MONEY format to monetary strings, see the Informix® DataBlade® API Programmer's Guide.

Return values

An mi_string pointer
A pointer to the monetary string equivalent of money_data.
NULL
The function was not successful.