help/free

   1 NAME
   2     free - free the memory used to store values of lvalues
   3
   4 SYNOPSIS
   5     free(a, b, ...)
   6
   7 TYPES
   8     a, b, ...   any
   9
  10     return      null value
  11
  12 DESCRIPTION
  13     Those of the arguments a, b, ... that specify lvalues are assigned
  14     the null value, effectively freeing whatever memory is used to
  15     store their current values.  Other arguments are ignored.
  16
  17     free(.) frees the current "old value".
  18
  19 EXAMPLE
  20     > a = 7
  21     > mat M[3] = {1, list(2,3,4), list(5,6)}
  22     > print memsize(a), memsize(M)
  23     80 736
  24
  25     > free(a, M[1])
  26     > print memsize(a), memsize(M)
  27     16 424
  28
  29 LIMITS
  30     none
  31
  32 LINK LIBRARY
  33     none
  34
  35 SEE ALSO
  36     freeglobals, freestatics, freeredc
  37