numpy.full#

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

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

参数:
shapeint 或 int 序列

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

fill_value标量或类数组

填充值。

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

np.array(fill_value).dtype.

order{‘C’, ‘F’}, optional

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

devicestr,可选

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

版本 2.0.0 中新增。

likearray_like, optional

用于创建非 NumPy 数组的引荐对象。如果传入的 like 支持 __array_function__ 协议,则结果将由它定义。在这种情况下,它确保创建与通过此参数传入的数组兼容的数组对象。

版本 1.20.0 中新增。

返回:
outndarray

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

另请参阅

full_like

返回一个形状与输入相同、并用值填充的新数组。

empty

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

ones

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

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