Function:     zadd

Purpose:      Converts fchar to ASCIIZ string.

Category:     UTILITY

File:         gclib.c

Author:       J.P. Terlouw

Use:          char *zadd( fchar fc )

              zadd       Returns a pointer to the newly created
                         ASCIIZ string.
              fc         Input fchar. All charcters (discarding
                         trailing blanks and zeroes) are copied to
                         the ASCIIZ string.

Notes:        - zadd is defined in "gipsyc.h".
              - zadd allocates space for the ASCIIZ string with
              malloc, which can be freed with free.
              Therefore the pointer returned by zadd may not be lost, i.e.
              statements like
                 printf( "%s\n", zadd( fc ) );
              must be avoided. One should use instead an intermediate
              variable:
                 char *ptr = zadd( fc );
                 printf( "%s\n", ptr );
                 free( ptr );

Updates:      Feb 27, 1990: KGB, Document created.