c_cpp/etc/calc/help/blkfree

   1 NAME
   2     blkfree - free memory allocated to named block
   3
   4 SYNOPSIS
   5     blkfree(val)
   6
   7 TYPES
   8     val         named block, string, or integer
   9
  10     return      null value
  11
  12 DESCRIPTION
  13     If val is a named block, or the name of a named block, or the
  14     identifying index for a named block, blkfree(val) frees the
  15     memory block allocated to this named block.  The block remains
  16     in existence with the same name, identifying index, and chunksize,
  17     but its size and maxsize becomes zero and the pointer for the start
  18     of its data block null.
  19
  20     A new block of memory may be allocated to a freed block B by
  21     blk(B [, len, chunk]), len defaulting to zero and chunk to the
  22     chunksize when the block was freed.
  23
  24 EXAMPLE
  25
  26     ; B1 = blk("foo")
  27     ; B2 = blk("Second block")
  28     show blocks
  29      id   name
  30     ----  -----
  31      0   foo
  32      1   Second block
  33
  34     ; blkfree(B1)
  35     ; show blocks
  36      id   name
  37     ----  -----
  38      1   Second block
  39
  40     ; B1
  41         block 0: foo
  42         chunksize = 256, maxsize = 0, datalen = 0
  43         NULL
  44
  45     ; blk(B1); B[7] = 5
  46     ; B1
  47         block 0: foo
  48         chunksize = 256, maxsize = 256, datalen = 8
  49         0000000000000005
  50
  51 LIMITS
  52     none
  53
  54 LINK LIBRARY
  55     none
  56
  57 SEE ALSO
  58     blk, blocks
  59
  60 ## Copyright (C) 1999  Landon Curt Noll
  61 ##
  62 ## Calc is open software; you can redistribute it and/or modify it under
  63 ## the terms of the version 2.1 of the GNU Lesser General Public License
  64 ## as published by the Free Software Foundation.
  65 ##
  66 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  67 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  68 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  69 ## Public License for more details.
  70 ##
  71 ## A copy of version 2.1 of the GNU Lesser General Public License is
  72 ## distributed with calc under the filename COPYING-LGPL.  You should have
  73 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  74 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  75 ##
  76 ## @(#) $Revision: 30.1 $
  77 ## @(#) $Id: blkfree,v 30.1 2007/03/16 11:10:42 chongo Exp $
  78 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/blkfree,v $
  79 ##
  80 ## Under source code control:   1997/04/05 13:07:13
  81 ## File existed as early as:    1997
  82 ##
  83 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  84 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/