numpy.full#

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

傳回一個以 fill_value 填充,具有給定形狀和類型的新陣列。

參數:
shapeint 或 ints 序列

新陣列的形狀,例如 (2, 3)2

fill_value純量或類陣列

填充值。

dtype資料類型,選用
陣列所需的資料類型。預設值 None 表示

np.array(fill_value).dtype.

order{‘C’, ‘F’}, 選用

是否以 C 或 Fortran 相鄰(row-major 或 column-major)順序儲存多維資料在記憶體中。

devicestr,選用

放置建立的陣列的裝置。預設值:None。僅為了 Array-API 的互通性,如果傳遞則必須為 "cpu"

版本 2.0.0 新增。

like類陣列,選用

參考物件,允許建立非 NumPy 陣列的陣列。如果作為 like 傳入的類陣列支援 __array_function__ 協定,則結果將由其定義。在這種情況下,它確保建立與透過此引數傳入的物件相容的陣列物件。

版本 1.20.0 新增。

傳回值:
outndarray

具有給定形狀、dtype 和順序的 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]])