FTIMETOA C-3


NAME



ftimetoa - format TIME value to ASCII equivalent

SYNOPSIS



#include

int ftimetoa (t, format, dest, len)
TIME t;
char *format;
char *dest;
int len;

DESCRIPTION



Ftimetoa converts the TIME value t into its ASCII 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 TIME value parameter represents the number of seconds from
midnight. Midnight has a TIME value of 1.

SEE ALSO



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

DIAGNOSTICS

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

FEDIT the TIME value t is invalid