numpy.ndarray.flags#

属性

ndarray.flags#

关于数组内存布局的信息。

注意

可以通过类似字典的方式（如 a.flags['WRITEABLE']）或使用小写属性名（如 a.flags.writeable）访问 flags 对象。短标志名仅支持字典访问。

只有 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。

本页内容