numpy.empty#

numpy.empty(shape, dtype=float, order='C', *, device=None, like=None)#

回傳一個具有給定形狀和型別的新陣列,但不初始化條目。

參數:
shapeint 或 int 元組

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

dtype資料型別,選用

陣列的所需輸出資料型別,例如, numpy.int8。預設值為 numpy.float64

order{‘C’, ‘F’},選用,預設值: ‘C’

指定在記憶體中以 row-major (C-style) 或 column-major (Fortran-style) 順序儲存多維資料。

devicestr,選用

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

2.0.0 版本新增。

likearray_like,選用

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

1.20.0 版本新增。

回傳值:
outndarray

具有給定形狀、dtype 和順序的未初始化(任意)資料陣列。物件陣列將初始化為 None。

另請參閱

empty_like

回傳一個具有與輸入相同形狀和型別的空陣列。

ones

回傳一個將值設定為 1 的新陣列。

zeros

回傳一個將值設定為零的新陣列。

full

回傳一個以給定值填滿的指定形狀的新陣列。

註解

與其他陣列建立函式(例如 zerosonesfull)不同, empty 不會初始化陣列的值,因此可能稍微快一點。但是,新分配的陣列中儲存的值是任意的。為了獲得可重現的行為,請務必在讀取之前設定陣列的每個元素。

範例

>>> import numpy as np
>>> np.empty([2, 2])
array([[ -9.74499359e+001,   6.69583040e-309],
       [  2.13182611e-314,   3.06959433e-309]])         #uninitialized
>>> np.empty([2, 2], dtype=int)
array([[-1073741821, -1067949133],
       [  496041986,    19249760]])                     #uninitialized