c_cpp/etc/calc/help/sizeof

   1 NAME
   2     sizeof - number of bytes required for value
   3
   4 SYNOPSIS
   5     sizeof(x)
   6
   7 TYPES
   8     x           any
   9
  10     return      integer
  11
  12 DESCRIPTION
  13     This is analogous to the C operator sizeof for the value only.
  14     It attempts to assess the number of bytes in memory used to store
  15     a value and all of its components.  Unlike memsize(x), this
  16     builtin does not include the size of the overhead.
  17
  18     Unlike size(x), this builtin incldues the trailing \0 byte on the
  19     end of strings.
  20
  21     For numeric values, sizeof(x) ignores the demoninator if 'x' is
  22     an integer.  For complex values, sizeof(x) ignores the imaginary
  23     part if 'x' is real.  Because the 0, 1 and -1 numeric values are
  24     shared static values, sizeof(x) reports such values as having
  25     0 bytes of storage.
  26
  27     The number returned by sizeof(x) may be less than the actual number
  28     used because, for example, more memory may have been allocated for
  29     a string than is used: only the characters up to and including the
  30     first '\0' are counted in calculating the contribution of the
  31     string to sizeof(x).
  32
  33     The number returned by sizeof(x) may be greater (and indeed
  34     substantially greater) than the number of bytes actually used.
  35     For example, after:
  36
  37                 a = sqrt(2);
  38                 mat A[3] = {a, a, a};
  39
  40     the numerical information for a, A[0], A[1], A[2] are stored in the
  41     same memory, so the memory used for A is the same as if
  42     its 3 elements were null values.  The value returned by
  43     sizeof(A) is calculated as A were defined by:
  44
  45                 mat A[3] = {sqrt(2), sqrt(2), sqrt(2)}.
  46
  47     Similar sharing of memory occurs with literal strings.
  48
  49     For associative arrays, only the value part of the name/value pair
  50     is counted.
  51
  52     The minimum value for sizeof(x) occurs for the null and error values.
  53
  54 EXAMPLES
  55     The results for examples like these will depend to some extent on
  56     the system being used.  The following were for an SGI R4k machine
  57     in 32-bit mode:
  58
  59     ; print sizeof(null()), sizeof(0), sizeof(3), sizeof(2^32 - 1), sizeof(2^32)
  60     8 68 68 68 72
  61
  62     ; x = sqrt(2, 1e-100); print sizeof(x), sizeof(num(x)), sizeof(den(x))
  63     148 108 108
  64
  65     ; print sizeof(list()), sizeof(list(1)), sizeof(list(1,2))
  66     28 104 180
  67
  68     ; print sizeof(list()),sizeof(list(1)),sizeof(list(1,2)),sizeof(list(1,2,3))
  69     28 104 180 256
  70
  71     ; mat A[] = {1}; mat B[] = {1,2}; mat C[] = {1,2,3}; mat D[100,100];
  72     ; print sizeof(A), sizeof(B), sizeof(C), sizeof(D)
  73     124 192 260 680056
  74
  75     ; obj point {x,y,z}
  76     ; obj point P = {1,2,3}; print sizeof(P)
  77     274
  78
  79 LIMITS
  80     It is assumed sizeof(x) will fit into a system long integer.
  81
  82 LINK LIBRARY
  83     none
  84
  85 SEE ALSO
  86     size, fsize, strlen, digits
  87
  88 ## Copyright (C) 1999  Landon Curt Noll
  89 ##
  90 ## Calc is open software; you can redistribute it and/or modify it under
  91 ## the terms of the version 2.1 of the GNU Lesser General Public License
  92 ## as published by the Free Software Foundation.
  93 ##
  94 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  95 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  96 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  97 ## Public License for more details.
  98 ##
  99 ## A copy of version 2.1 of the GNU Lesser General Public License is
 100 ## distributed with calc under the filename COPYING-LGPL.  You should have
 101 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 102 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 103 ##
 104 ## @(#) $Revision: 30.1 $
 105 ## @(#) $Id: sizeof,v 30.1 2007/03/16 11:10:42 chongo Exp $
 106 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/sizeof,v $
 107 ##
 108 ## Under source code control:   1996/05/24 02:04:04
 109 ## File existed as early as:    1996
 110 ##
 111 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 112 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/