FBOOLTOA C-3


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