NAME
ftimetoa - format TIME value to ASCII equivalent
SYNOPSIS
#include <cbase/dtypes.h>
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 <cbase/dtypes.h>:
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