FBOOLTOA C-3





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



NAME


fbooltoa - format BOOLEAN value to ASCII

SYNOPSIS


#include 

int fbooltoa (b, format, dest, len)
BOOLEAN b;
char *format;
char *dest;
int len;

DESCRIPTION


Fbooltoa formats the BOOLEAN value b to its ASCII representation,
storing the result in dest: a string of len bytes. The number of
bytes in the formatted result is returned.

If the BOOLEAN value is TRUE (non-zero), the first specifier in
format is used. Otherwise, the second specifier in format is
used.

SEE ALSO


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

DIAGNOSTICS

If an error occurs, fbooltoa returns a negative number and the
content of dest is undefined. The following symbolic error codes
are defined in :

          FTOOBIG   format is larger than the destination length,
                    len

          FFORMAT   format does not contain two specifiers or if
                    one of  the specifiers is empty