.-
help for ^memchk^                                        (STB-40: ip20)
.-

Checking for sufficient memory to add variables
----------------------------------------------

   ^memchk^ [^int^ #] [^byte^ #] [^long^ #] [^double^ #] [^str^# #]


Description
-----------

^memchk^ is a modification of the defunct ^memsize^. It is designed to be used
by programmers at the beginning of a program that creates many temporary
variables. The programmer states how many new variables of various types
(e.g., integers, floats, etc.) will be created and ^memchk^ checks that
there is sufficient memory. If there is sufficient, ^memchk^ is silent. If not, 
^memchk^ issues an error message and return code 900.

^memchk^ is most useful when one has a large data set and a computer intensive
program that generates several temporary variables. If the program includes
^memchk^ early on, then it will exit early rather than producing the 
message ^no room to add more variables^ after running for several
seconds or even minutes.


Author
------

      Peter Sasieni
      Imperial Cancer Research Fund, UK 
      email: p.sasieni@@icrf.icnet.uk


Also See
--------

    STB:  STB-40 ip20