informix
Informix DataBlade API Programmer's Manual
DataBlade API Function Descriptions

mi_string_to_money()

The mi_string_to_money() function converts a text (string) representation of a monetary value to its binary (internal) MONEY representation.

Syntax

Usage

The mi_string_to_money() function converts the monetary string that money_string references to its the internal MONEY value. An internal MONEY value is the format that the database server uses to store a value in a MONEY column of the database. This format represents a fixed-point decimal number.

Important: The mi_string_to_money() function replaces the mi_money_to_binary() function for string-to-internal-MONEY conversion in DataBlade API modules.

The mi_string_to_money() function accepts the monetary string in the monetary format of the current processing locale. For more information, see the Informix Guide to GLS Functionality.

Return Values

mi_money * is a pointer to the internal MONEY representation that mi_string_to_money() has created.
NULL indicates that the function was not successful.

Related Topics

See the descriptions of the following functions: mi_money_to_string(), mi_string_to_date(), mi_string_to_datetime(), mi_string_to_decimal(), and mi_string_to_interval().

For more information on how to convert monetary strings to internal MONEY format, see Converting Decimal Data.


Informix DataBlade API Programmer's Manual, Version 9.2
Copyright © 1999, Informix Software, Inc. All rights reserved