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

 BLIMEMAVL()
------------------------------------------------------------------------------
 Purpose:
 Get CA-Clipper total free dynamic memory.

 Syntax:
 nlValue = BLIMEMAVL()

 Parameters:
 None.

 Returns:
 Total available memory in bytes.

 Description:
 This function returns the total dynamic memory available in bytes in the
 CA-Clipper free pool. 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 total available memory                                           
 //                                                                          
 ? "There are currently", BLIMEMAVL()                                        
 ?? " bytes available in CA-Clipper's free pool"