FBOOLTOA C-3

NAME

fbooltoa - format BOOLEAN value to ASCII

SYNOPSIS

#include <cbase/dtypes.h>

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 <cbase/dtypes.h>:

FTOOBIG format is larger than the destination length,

len

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