numpy.full#

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

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

参数:
shapeint 或 int 序列

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

fill_value标量或类数组

填充值。

dtype数据类型,可选
数组所需的 data-type。默认值 None 表示

np.array(fill_value).dtype.

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

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

devicestr,可选

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

版本 2.0.0 中的新功能。

like类数组,可选

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

版本 1.20.0 中的新功能。

返回值:
outndarray

具有给定形状、dtype 和 order 的 fill_value 数组。

另请参阅

full_like

返回一个具有输入形状的新数组,并用值填充。

empty

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

ones

返回一个将值设置为 1 的新数组。

zeros

返回一个将值设置为 0 的新数组。

示例

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