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