round

round(x: array, /) array

Rounds each element x_i of the input array x to the nearest integer-valued number.

Special cases

  • If x_i is already integer-valued, the result is x_i.

For floating-point operands,

  • If x_i is +infinity, the result is +infinity.

  • If x_i is -infinity, the result is -infinity.

  • If x_i is +0, the result is +0.

  • If x_i is -0, the result is -0.

  • If x_i is NaN, the result is NaN.

  • If two integers are equally close to x_i, the result is the even integer closest to x_i.

Parameters:

x (array) – input array. Should have a numeric data type.

Returns:

out (array) – an array containing the rounded result for each element in x. The returned array must have the same data type as x.