dpnp.trunc

dpnp.trunc(x, out=None, where=True, order='K', dtype=None, subok=True, **kwargs)

Returns the truncated value for each element x_i for input array x.

The truncated value of the scalar x is the nearest integer i which is closer to zero than x is. In short, the fractional part of the signed number x is discarded.

Parameters:

  • x ({dpnp.ndarray, usm_ndarray}) -- Input array, expected to have a real-valued data type.

  • out ({None, dpnp.ndarray, usm_ndarray}, optional) -- Output array to populate. Array must have the correct shape and the expected data type. Default: None.

  • order ({"C", "F", "A", "K"}, optional) -- Memory layout of the newly output array, if parameter out is None. Default: "K".

Returns:

out -- An array containing the result of element-wise division. The data type of the returned array is determined by the Type Promotion Rules.

Return type:

dpnp.ndarray

Limitations

Parameters where and subok are supported with their default values. Keyword argument kwargs is currently unsupported. Otherwise NotImplementedError exception will be raised.

See also

dpnp.floor

Round a number to the nearest integer toward minus infinity.

dpnp.ceil

Round a number to the nearest integer toward infinity.

dpnp.rint

Round elements of the array to the nearest integer.

dpnp.fix

Round to nearest integer towards zero, element-wise.

Examples

>>> import dpnp as np
>>> a = np.array([-1.7, -1.5, -0.2, 0.2, 1.5, 1.7, 2.0])
>>> np.trunc(a)
array([-1.0, -1.0, -0.0, 0.0, 1.0, 1.0, 2.0])