dpnp.divmod¶

dpnp.divmod = <DPNPBinaryTwoOutputsFunc 'divmod'>¶

Calculates the quotient and the remainder for each element \(x1_i\) of the input array x1 with the respective element \(x2_i\) of the input array x2.

For full documentation refer to numpy.divmod.

Parameters:

x1{dpnp.ndarray, usm_ndarray}

Dividend input array, expected to have a real-valued floating-point data type.

x2{dpnp.ndarray, usm_ndarray}

Divisor input array, expected to have a real-valued floating-point data type.

out1{None, dpnp.ndarray, usm_ndarray}, optional

Output array for the quotient to populate. Array must have a shape that the inputs broadcast to and the expected data type.

Default: None.

out2{None, dpnp.ndarray, usm_ndarray}, optional

Output array for the remainder to populate. Array must have a shape that the inputs broadcast to and the expected data type.

Default: None.

outtuple of None, dpnp.ndarray, or usm_ndarray, optional

A location into which the result is stored. If provided, it must be a tuple and have length equal to the number of outputs. Each provided array must have a shape that the inputs broadcast to and the expected data type. It is prohibited to pass output arrays through out keyword when either out1 or out2 is passed.

Default: (None, None).

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

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

Default: "K".

Returns:

quotientdpnp.ndarray: Element-wise quotient resulting from floor division.
remainderdpnp.ndarray: Element-wise remainder from floor division.

Limitations

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

See also

dpnp.floor_divide: Equivalent to Python's \(//\) operator.
dpnp.remainder: Equivalent to Python's \(\%\) operator.
dpnp.modf: Equivalent to divmod(x, 1) for positive x with the return values switched.

Notes

At least one of x1 or x2 must be an array.

If x1.shape != x2.shape, they must be broadcastable to a common shape (which becomes the shape of the output).

Equivalent to \((x1 // x2, x1 \% x2)\), but faster because it avoids redundant work. It is used to implement the Python built-in function divmod() on dpnp.ndarray.

Complex dtypes are not supported, they will raise a TypeError.

Examples

>>> import dpnp as np
>>> np.divmod(np.arange(5), 3)
(array([0, 0, 0, 1, 1]), array([0, 1, 2, 0, 1]))

The Python built-in function divmod() can be used as a shorthand for np.divmod on dpnp.ndarray.

>>> x = np.arange(5)
>>> divmod(x, 3)
(array([0, 0, 0, 1, 1]), array([0, 1, 2, 0, 1]))