numpy.divmod

numpy.divmod(x1, x2, [out1, out2, ]/, [out=(None, None), ]*, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'divmod'>

同时返回元素级的商和余数.

在 1.13.0 版本加入.

np.divmod(x, y) 等同于 (x // y, x % y),但由于避免了重复工作,速度更快.它用于在 NumPy 数组上实现 Python 内置函数 divmod.

参数:

x1array_like

股息数组.

x2array_like

除数数组.如果 x1.shape != x2.shape,它们必须能够广播到一个共同的形状（这将成为输出形状）.

outndarray, None, 或 ndarray 和 None 的元组, 可选

存储结果的位置.如果提供,它必须具有与输入广播的形状.如果未提供或为 None,则返回一个新分配的数组.元组（只能作为关键字参数）的长度必须等于输出数量.

wherearray_like, 可选

这个条件通过输入进行广播.在条件为 True 的位置,`out` 数组将被设置为 ufunc 结果.在其他地方,`out` 数组将保留其原始值.注意,如果通过默认的 out=None 创建了一个未初始化的 out 数组,条件为 False 的位置将保持未初始化状态.

**kwargs

对于其他仅限关键字的参数,请参阅 ufunc 文档.

返回:

out1ndarray

逐元素的商,由地板除法产生.如果 x1 和 x2 都是标量,则这是一个标量.

out2ndarray

逐元素的向下取整除法的余数.如果 x1 和 x2 都是标量,则这是一个标量.

参见

floor_divide

等同于 Python 的 // 运算符.

remainder

等同于 Python 的 % 运算符.

modf

对于正数 x ,相当于 divmod(x, 1) ,但返回值互换.

示例

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

divmod 函数可以用作 ndarrays 上 np.divmod 的简写.

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