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。