numpy.full#

numpy.full(shape, fill_value, dtype=None, order='C', *, device=None, like=None)[源代码]#

返回一个具有给定形状和类型的新数组,填充了 fill_value .

参数:
shapeint 或 int 序列

新数组的形状,例如 (2, 3)2 .

fill_value标量或类数组

填充值.

dtypedata-type,可选
数组所需的数据类型. 默认值 None 表示

np.array(fill_value).dtype .

order{‘C’, ‘F’},可选

是否在内存中以 C 或 Fortran 连续(行或列方式)顺序存储多维数据.

devicestr, optional

用于放置所创建的数组的设备.默认值:None.仅用于 Array-API 互操作性,因此如果传递,则必须为 "cpu" .

在 2.0.0 版本加入.

likearray_like, optional

参考对象以允许创建非NumPy数组的数组. 如果作为 like 传入的类数组支持 __array_function__ 协议,则结果将由它定义. 在这种情况下,它可以确保创建与通过此参数传入的数组对象兼容的数组对象.

在 1.20.0 版本加入.

返回:
outndarray

具有给定形状,dtype 和顺序的 fill_value 数组.

参见

full_like

返回一个与输入数组形状相同,并使用给定值填充的新数组.

empty

返回一个新的未初始化的数组.

ones

返回一个将所有值设置为 1 的新数组.

zeros

返回一个将所有值设置为零的新数组.

示例

>>> import numpy as np
>>> np.full((2, 2), np.inf)
array([[inf, inf],
       [inf, inf]])
>>> np.full((2, 2), 10)
array([[10, 10],
       [10, 10]])
>>> np.full((2, 2), [1, 2])
array([[1, 2],
       [1, 2]])