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
回傳一個以給定值填滿的指定形狀的新陣列。
註解
與其他陣列建立函式(例如
zeros
、ones
、full
)不同,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