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

h_memory()              Get free memory down to block size.
----------------------------------------------------------------------------------------

 Syntax:

 int_ret = h_memory0( [<block>] )

 [<block>] N    how large a block to recognize when counting in kilobytes
                (optional), minimum is 1 default is 4

 Description:

 This function gets free memory, at block size and returns the amount of
 available memory, in kilobytes (K).  h_memory() allocates all 64K blocks,
 32K blocks, 16K blocks, and so on, until it cannot allocate any more 
 blocks of the block size or bigger.

----------------------------------[ Example ]------------------------------------

 * see what is available before routine, check 1K blocks
 before = h_memory0(1)
 * do routine for which h_graph has reported problems
 DO nasty_rtn
 * see what is available after routine, check 1K blocks
 after = h_memory0(1)