NAME
    bround - round a value to a number of binary places

SYNOPSIS
    bround(x [,j])

TYPES
    x		real, complex, object (calls xx_bround)
    j		int

    return	(same type as x)

DESCRIPTION
    Round x to j binary places.  If j is omitted, 0 places is assumed.

    Rounding of a non-integer produces values nearer to the nearest integer.

EXAMPLE
    > print bround(pi()), bround(pi(), 10), bround(sqrt(-3), 15)
    3 3.1416015625 1.7320556640625i

    > print bround(3.3), bround(3.7), bround(3.3, 2), bround(3.7, 2)
    3 4 3.25 3.75

    > print bround(-3.3), bround(-3.7), bround(-3.3, 2), bround(-3.7, 2)
    -3 -4 -3.25 -3.75

LIMITS
    0 <= j < 2^31

LIBRARY
    void broundvalue(VALUE *x, *j, *vres)

SEE ALSO
    btrunc, int, round, trunc
