FREALTOA C-3





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


frealtoa - format REAL to ASCII

SYNOPSIS


#include 

int frealtoa (r, format, dest, len, dec)
REAL r;
char *format;
char *dest;
int len;
int dec;

DESCRIPTION


Frealtoa converts the floating point value r to an ASCII string
with format, storing the result in dest: a string of len bytes.
The number of bytes used in the formatted result is returned.

If there are more than 15 digits to the left of the decimal
point, scientific notation of the form [-]n.n[n...]e[-]nn is
forced.

If dec is a zero or positive value, it is taken as the number of
decimal places to be formatted. This number overrides the number
of decimal places in the format string. If the value to be
converted contains fewer than dec decimal places, zeros are
inserted at the end of the number. If the value contains more
decimal places, the value is rounded at dec decimal places.

SEE ALSO


getfreal(C-3), realtoa(C-3)
C/Base Reference Manual Chapter 13, "Formatting Data Values"

DIAGNOSTICS

If an error occurs, frealtoa returns a negative number and the
contents of dest are undefined. The following symbolic error
codes are defined in :

          FTOOBIG   the formatted result is longer than the
                    destination length, len

          FFORMAT   format is empty or contains invalid key
                    letters