ufmFreeBitmap(3w)

NAME
     ufmFreeBitmap - free a character bitmap

C SYNOPSIS
     #include <ufm.h>

     int ufmFreeBitmap(unsigned int nCharBitmaps, ufmBitmap *charBitmaps)

DESCRIPTION
     ufmFreeBitmap frees the memory ufmGetBitmap allocated for one or more
     data structures of the type ufmBitmap.

     When ufmGetBitmap allocates an array of one or more data structures of
     the type ufmBitmap, it returns the number of allocated data structures
     (nCharBitmaps) and the address of that array (charBitmaps).  When you are
     finished with that array, you can free it by calling ufmFreeBitmap with
     the argument values that were returned by ufmGetBitmap.

SEE ALSO
     ufmGetBitmap(3w).

DIAGNOSTICS
     If you specify a value less than 1 for nCharBitmaps or a NULL pointer for
     charBitmaps, ufmFreeBitmap will return the value UFM_INVALID_VALUE.
     Else, it will return the value UFM_NO_ERROR.  UFM_INVALID_VALUE and
     UFM_NO_ERROR are defined in the header file <ufm.h>.