numpy.full#

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

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

参数:
shapeint 或整数序列

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

fill_value标量或类数组

填充值。

dtype数据类型,可选
数组所需的数 据类型。默认为 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 和顺序的 fill_value 数组。

另请参阅

full_like

返回一个填充值为value的新数组,形状与输入相同。

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