dpnp.trunc¶

dpnp.trunc = <DPNPUnaryFunc 'trunc'>¶

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 boolean or real-valued data type.

out{None, dpnp.ndarray, usm_ndarray, tuple of ndarray}, optional

Output array to populate. Array must have the correct shape and the expected data type. A tuple (possible only as a keyword argument) must have length equal to the number of outputs.

Default: None.

order{None, "C", "F", "A", "K"}, optional

Memory layout of the newly output array, if parameter out is None.

Default: "K".

Returns:

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

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])