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 版本加入.

like类数组,可选

引用对象,允许创建非 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]])