NAME
    round - round a value to a number of decimal places

SYNOPSIS
    round(x [,j])

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

    return	(same type as x)

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

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

EXAMPLE
    > print round(pi()), round(pi(), 5), round(sqrt(-3), 8)
    3 3.14159 1.73205081i

    > print round(3.333), round(3.789), round(3.333, 2), round(3.789, 2)
    3 4 3.33 3.79

    > print round(-3.333), round(-3.789), round(-3.333, 2), round(-3.789, 2)
    -3 -4 -3.33 -3.79

LIMITS
    0 <= j < 2^31

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

SEE ALSO
    bround, btrunc, int, trunc
