FLONGTOA C-3





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



NAME


flongtoa - format LONG to ASCII

SYNOPSIS


#include 

int flongtoa (l, format, dest, len)
LONG l;
char *format;
char *dest;
int len;

DESCRIPTION


Flongtoa converts the LONG value l to its ASCII string
representation with format, storing the result in dest: a string
of len bytes. The number of bytes used in the formatted result is
returned.

The parameter passed to flongtoa must be a long integer (long).
This is not necessarily the same as just integer (int). To make
sure the correct value type is passed, the parameter should
always be cast as a long: 

rc = flongtoa ((long) counts, fmt, dest, sizeof (dest));

SEE ALSO


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

DIAGNOSTICS

If an error occurs, flongtoa 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