FTIMETOA C-3





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



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