c_cpp/etc/calc/help/blocks

   1 NAME
   2     blocks - return a named block or number of unfreed named blocks
   3
   4 SYNOPSIS
   5     blocks([id])
   6
   7 TYPES
   8     id          non-negative integer
   9
  10     return      named block or null value
  11
  12 DESCRIPTION
  13     With no argument blocks() returns the number of blocks that have
  14     been created but not freed by the blkfree function.
  15
  16     With argument id less than the number of named blocks that have been
  17     created, blocks(id) returns the named block with identifying index id.
  18     These indices 0, 1, 2, ... are assigned to named blocks in the order
  19     of their creation.
  20
  21 EXAMPLE
  22
  23     ; A = blk("alpha")
  24     ; B = blk("beta") = {1,2,3}
  25     ; blocks()
  26         2
  27     ; blocks(1)
  28         block 1: beta
  29         chunksize = 256, maxsize = 256, datalen = 3
  30         010203
  31     ; blocks(2)
  32         Error 10211
  33     ; strerror()
  34         "Non-allocated index number for blocks"
  35
  36 LIMITS
  37     none
  38
  39 LINK LIBRARY
  40     none
  41
  42 SEE ALSO
  43     blk, blkfree
  44
  45 ## Copyright (C) 1999  Landon Curt Noll
  46 ##
  47 ## Calc is open software; you can redistribute it and/or modify it under
  48 ## the terms of the version 2.1 of the GNU Lesser General Public License
  49 ## as published by the Free Software Foundation.
  50 ##
  51 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  52 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  53 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  54 ## Public License for more details.
  55 ##
  56 ## A copy of version 2.1 of the GNU Lesser General Public License is
  57 ## distributed with calc under the filename COPYING-LGPL.  You should have
  58 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  59 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  60 ##
  61 ## @(#) $Revision: 30.1 $
  62 ## @(#) $Id: blocks,v 30.1 2007/03/16 11:10:42 chongo Exp $
  63 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/blocks,v $
  64 ##
  65 ## Under source code control:   1997/04/05 13:07:13
  66 ## File existed as early as:    1997
  67 ##
  68 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  69 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/