numpy.put#

numpy.put(a, ind, v, mode='raise')[源代码]#

用给定的值替换数组的指定元素。

索引操作作用于扁平化的目标数组。 put 大致等同于

a.flat[ind] = v
参数:
andarray

目标数组。

indarray_like

目标索引，解释为整数。

v数组类

要放置在 a 中目标索引的值。如果 v 比 ind 短，它将被重复使用。

mode{‘raise’, ‘wrap’, ‘clip’}, optional

指定越界索引的行为。

  • ‘raise’ – 引发错误（默认）

  • ‘wrap’ – 环绕

  • ‘clip’ – 剪辑到范围

‘clip’ 模式意味着所有过大的索引都被替换为寻址该轴上最后一个元素的索引。请注意，这会禁用负数索引。在 ‘raise’ 模式下，如果发生异常，目标数组仍可能被修改。

另请参阅

putmask, place
put_along_axis

通过匹配数组和索引数组来放置元素

示例

>>> import numpy as np
>>> a = np.arange(5)
>>> np.put(a, [0, 2], [-44, -55])
>>> a
array([-44,   1, -55,   3,   4])

>>> a = np.arange(5)
>>> np.put(a, 22, -5, mode='clip')
>>> a
array([ 0,  1,  2,  3, -5])
在此页面