numpy.ndarray.flags#
屬性
- ndarray.flags#
關於陣列記憶體佈局的資訊。
註解
可以像字典一樣存取
flags
物件(例如a.flags['WRITEABLE']
),或使用小寫屬性名稱(例如a.flags.writeable
)。只有字典存取支援簡短旗標名稱。只有 WRITEBACKIFCOPY、WRITEABLE 和 ALIGNED 旗標可以由使用者變更,透過直接賦值給屬性或字典條目,或呼叫
ndarray.setflags
。陣列旗標不能任意設定
WRITEBACKIFCOPY 只能設定為
False
。如果資料確實對齊,ALIGNED 只能設定為
True
。如果陣列擁有自己的記憶體,或記憶體的最終擁有者公開可寫入的緩衝區介面,或者是一個字串,WRITEABLE 才能設定為
True
。
陣列可以同時是 C 風格和 Fortran 風格的連續。這對於一維陣列來說很清楚,但對於更高維度的陣列也可能是真的。
即使對於連續陣列,如果
arr.shape[dim] == 1
或陣列沒有元素,給定維度的步幅arr.strides[dim]
也可能是任意的。對於 C 風格的連續陣列,通常不成立self.strides[-1] == self.itemsize
,對於 Fortran 風格的連續陣列,通常也不成立self.strides[0] == self.itemsize
。- 屬性:
- C_CONTIGUOUS (C)
資料位於單一的 C 風格連續區段中。
- F_CONTIGUOUS (F)
資料位於單一的 Fortran 風格連續區段中。
- OWNDATA (O)
陣列擁有它使用的記憶體,或從另一個物件借用記憶體。
- WRITEABLE (W)
資料區域可以寫入。將其設定為 False 會鎖定資料,使其成為唯讀。視圖(切片等)在建立時從其基礎陣列繼承 WRITEABLE,但可寫入陣列的視圖可能會在基礎陣列保持可寫入的同時被鎖定。(反之則不然,鎖定陣列的視圖不能變成可寫入的。然而,目前鎖定基礎物件不會鎖定任何已經參考它的視圖,因此在這種情況下,有可能透過先前建立的可寫入視圖來更改鎖定陣列的內容。)嘗試更改不可寫入的陣列會引發 RuntimeError 例外。
- ALIGNED (A)
資料和所有元素都針對硬體適當地對齊。
- WRITEBACKIFCOPY (X)
此陣列是另一個陣列的副本。在解除分配之前,必須呼叫 C-API 函數 PyArray_ResolveWritebackIfCopy,基礎陣列才會使用此陣列的內容更新。
- FNC
F_CONTIGUOUS 且非 C_CONTIGUOUS。
- FORC
F_CONTIGUOUS 或 C_CONTIGUOUS(單區段測試)。
- BEHAVED (B)
ALIGNED 且 WRITEABLE。
- CARRAY (CA)
BEHAVED 且 C_CONTIGUOUS。
- FARRAY (FA)
BEHAVED 且 F_CONTIGUOUS 且非 C_CONTIGUOUS。