numpy.put#

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

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

索引作用于展平的目标数组. put 大致相当于:

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

目标数组.

indarray_like

目标索引,解释为整数.

varray_like

要放置在目标索引 a 中的值.如果 vind 短,它将根据需要重复.

模式{‘raise’, ‘wrap’, ‘clip’},可选

指定越界索引的行为.

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