numpy.matrix.flags

屬性

matrix.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。