c_cpp/etc/calc/help/lowbit

   1 NAME
   2     lowbit - index of lowest nonzero bit in binary representation of integer
   3
   4 SYNOPSIS
   5     lowbit(x)
   6
   7 TYPES
   8     x           nonzero integer
   9
  10     return      integer
  11
  12 DESCRIPTION
  13     If x is a nonzero integer, lowbit(x) returns the index of the
  14     lowest nonzero bit in the binary representation of abs(x).  Equivalently,
  15     lowbit(x) is the greatest integer for which x/2^n is an integer;
  16     the binary representation of x then ends with n zero bits.
  17
  18 EXAMPLE
  19     ; print lowbit(2), lowbit(3), lowbit(4), lowbit(-15), lowbit(2^27)
  20     1 0 2 0 27
  21
  22 LIMITS
  23     none
  24
  25 LINK LIBRARY
  26     long zlowbit(ZVALUE x);
  27
  28 SEE ALSO
  29     highbit, 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: lowbit,v 30.1 2007/03/16 11:10:42 chongo Exp $
  49 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/lowbit,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/