Click above to get retro games delivered to your door ever month!

 BLIMEMUSE()
------------------------------------------------------------------------------
 Purpose:
 Get the amount of used memory in the CA-Clipper Summer '87 memory area.

 Syntax:
 nlValue = BLIMEMUSE()

 Parameters:
 None.

 Returns:
 Sum of the sizes of all the memory blocks marked as used.

 Description:
 This function returns the size in bytes of all the dynamic memory currently
 in use. Dynamic memory is the memory used by CA-Clipper to store all
 temporary values of variables and buffers while an application is running.

 Note that the CA-Clipper Summer '87 free pool is allocated from DOS on an
 'as-needed' basis. Unless MEMORY(0), BLIMEMPAK(-1) or BLIMEMBLK() are
 executed (which cause CA-Clipper to allocate all available memory to the
 free pool from DOS), the value returned by this function will reflect only
 the currently allocated free pool.

 Example:
 // Get the amount of dynamic memory in use                                  
 //                                                                          
 ? BLIMEMUSE(), "bytes of dynamic memory are "                               
 ?? "currently in use"