numpy.recarray.setflags#
方法
- recarray.setflags(write=None, align=None, uic=None)#
分别设置数组标志 WRITEABLE、ALIGNED、WRITEBACKIFCOPY。
这些布尔值标志影响 NumPy 如何解释 a 使用的内存区域(见下面的注释)。ALIGNED 标志只能设置为 True,如果数据实际上根据类型对齐。WRITEBACKIFCOPY 标志永远不能设置为 True。WRITEABLE 标志只能设置为 True,如果数组拥有自己的内存,或者内存的最终所有者公开可写缓冲区接口,或者是一个字符串。(字符串的例外是为了允许在不复制内存的情况下进行解封。)
- 参数:
- writebool,可选
描述 a 是否可写。
- alignbool,可选
描述 a 是否与其类型正确对齐。
- uicbool,可选
描述 a 是否是另一个“基本”数组的副本。
注释
数组标志提供有关如何解释用于数组的内存区域的信息。有 7 个布尔标志在使用,其中只有 3 个可以由用户更改:WRITEBACKIFCOPY、WRITEABLE 和 ALIGNED。
WRITEABLE (W) 数据区域可写;
ALIGNED (A) 数据和步幅已针对硬件适当对齐(由编译器确定);
WRITEBACKIFCOPY (X) 此数组是另一个数组的副本(由 .base 引用)。当调用 C API 函数 PyArray_ResolveWritebackIfCopy 时,将使用此数组的内容更新基本数组。
所有标志可以使用单个(大写)字母以及完整名称来访问。
示例
>>> import numpy as np >>> y = np.array([[3, 1, 7], ... [2, 0, 0], ... [8, 5, 9]]) >>> y array([[3, 1, 7], [2, 0, 0], [8, 5, 9]]) >>> y.flags C_CONTIGUOUS : True F_CONTIGUOUS : False OWNDATA : True WRITEABLE : True ALIGNED : True WRITEBACKIFCOPY : False >>> y.setflags(write=0, align=0) >>> y.flags C_CONTIGUOUS : True F_CONTIGUOUS : False OWNDATA : True WRITEABLE : False ALIGNED : False WRITEBACKIFCOPY : False >>> y.setflags(uic=1) Traceback (most recent call last): File "<stdin>", line 1, in <module> ValueError: cannot set WRITEBACKIFCOPY flag to True