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

mi_decimal_to_string()

The mi_decimal_to_string() function creates a text (string) representation of a decimal value from the binary (internal) DECIMAL representation.

Syntax

Usage

The mi_decimal_to_string() function converts the internal DECIMAL value that decimal_data contains into a decimal string. An internal DECIMAL value is the format that the database server uses to store a value in a DECIMAL column of the database.

Important: The mi_decimal_to_string() function replaces the mi_binary_to_decimal() function for internal DECIMAL-to-string conversion in DataBlade API modules.

The mi_decimal_to_string() function formats the decimal string in the numeric format of the current processing locale. For more information, see the Informix Guide to GLS Functionality.

Return Values

mi_string * is a pointer to the decimal string that mi_decimal_to_string() has created.
NULL indicates that the function was not successful.

Related Topics

See the descriptions of the following functions: mi_date_to_string(), mi_datetime_to_string(), mi_interval_to_string(), mi_money_to_string(), and mi_string_to_decimal().

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


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