c_cpp/etc/calc/help/highbit

   1 NAME
   2     highbit - index of highest bit in binary representation of integer
   3
   4 SYNOPSIS
   5     highbit(x)
   6
   7 TYPES
   8     x           nonzero integer
   9
  10     return      integer
  11
  12 DESCRIPTION
  13     If x is a nonzero integer, highbit(x) returns the index of the
  14     highest bit in the binary representation of abs(x).  Equivalently,
  15     highbit(x) = n if 2^n <= abs(x) < 2^(n + 1);  the binary
  16     representation of x then has n + 1 digits.
  17
  18 EXAMPLE
  19     ; print highbit(2), highbit(3), highbit(4), highbit(-15), highbit(2^27)
  20     1 1 2 3 27
  21
  22 LIMITS
  23     none
  24
  25 LINK LIBRARY
  26     LEN zhighbit(ZVALUE x);
  27
  28 SEE ALSO
  29     lowbit, digits
  30
  31 ## Copyright (C) 1999  Landon Curt Noll
  32 ##
  33 ## Calc is open software; you can redistribute it and/or modify it under
  34 ## the terms of the version 2.1 of the GNU Lesser General Public License
  35 ## as published by the Free Software Foundation.
  36 ##
  37 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  38 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  39 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  40 ## Public License for more details.
  41 ##
  42 ## A copy of version 2.1 of the GNU Lesser General Public License is
  43 ## distributed with calc under the filename COPYING-LGPL.  You should have
  44 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  45 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  46 ##
  47 ## @(#) $Revision: 30.1 $
  48 ## @(#) $Id: highbit,v 30.1 2007/03/16 11:10:42 chongo Exp $
  49 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/highbit,v $
  50 ##
  51 ## Under source code control:   1995/10/03 10:40:02
  52 ## File existed as early as:    1995
  53 ##
  54 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  55 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/