NAME
    btrunc - truncate a value to a number of binary places

SYNOPSIS
    btrunc(x [,plcs])

TYPES
    x		real
    plcs	integer, defaults to zero

    return	real

DESCRIPTION
    Truncate x to plcs binary places, rounding if necessary towards zero,
    i.e. btrunc(x, plcs) is a multiple of 2^-plcs and the remainder
    x - btrunc(x, plcs) is either zero or has the same sign as x and
    absolute value less than 2^-plcs.  Here plcs may be positive, zero or
    negative.

    Except that it is defined only for real x, btrunc(x, plcs) is equivalent
    to bround(x, plcs, 2).  btrunc(x,0) and btrunc(x) are equivalent to
    int(x).

EXAMPLE
    ; print btrunc(pi()), btrunc(pi(), 10)
    3 3.140625

    ; print btrunc(3.3), btrunc(3.7), btrunc(3.3, 2), btrunc(3.7, 2)
    3 3 3.25 3.5

    ; print btrunc(-3.3), btrunc(-3.7), btrunc(-3.3, 2), btrunc(-3.7, 2)
    -3 -3 -3.25 -3.5

    ; print btrunc(55.123, -4), btrunc(-55.123, -4)
    48 -48

LIMITS
    abs(j) < 2^31

LINK LIBRARY
    NUMBER *qbtrunc(NUMBER *x, *j)

SEE ALSO
    bround, int, round, trunc

## Copyright (C) 1999  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## @(#) $Revision: 30.1 $
## @(#) $Id: btrunc,v 30.1 2007/03/16 11:10:42 chongo Exp $
## @(#) $Source: /usr/local/src/bin/calc/help/RCS/btrunc,v $
##
## Under source code control:	1994/09/30 00:44:27
## File existed as early as:	1994
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
