numpy.ndarray.ctypes#

属性

ndarray.ctypes#

一个简化数组与 ctypes 模块交互的对象。

此属性创建一个对象,使在使用 ctypes 模块调用共享库时更易于使用数组。返回的对象具有 data、shape 和 strides 属性(参见下面的注释),它们本身返回 ctypes 对象,这些对象可以用作共享库的参数。

参数:
返回值:
cPython 对象

具有属性 data、shape、strides 等。

注释

以下是此对象公开属性的说明,这些属性在“NumPy 指南”中有所记载(我们省略了未记载的公开属性,以及记载的私有属性)

_ctypes.data

一个指向数组内存区域的指针,以 Python 整数表示。该内存区域可能包含未对齐的数据,或者字节顺序不正确。该内存区域甚至可能不可写。在将此属性传递给任意 C 代码时,应遵守此数组的标志和数据类型,以避免出现问题,包括 Python 崩溃。用户注意!此属性的值与 self._array_interface_['data'][0] 完全相同。

请注意,与 data_as 不同,不会保留对数组的引用:类似 ctypes.c_void_p((a + b).ctypes.data) 的代码将导致指向已释放数组的指针,应改为写成 (a + b).ctypes.data_as(ctypes.c_void_p)

_ctypes.shape

(c_intp*self.ndim): 长度为 self.ndim 的 ctypes 数组,其中基类型是此平台上对应于 dtype('p') 的 C 整数(参见 c_intp)。此基类型可能是 ctypes.c_intctypes.c_longctypes.c_longlong,具体取决于平台。ctypes 数组包含底层数组的形状。

_ctypes.strides

(c_intp*self.ndim): 长度为 self.ndim 的 ctypes 数组,其中基类型与 shape 属性相同。此 ctypes 数组包含底层数组的步长信息。此步长信息对于显示要访问数组中下一个元素需要跳过多少字节非常重要。

_ctypes.data_as(obj)[source]

返回数据指针,强制转换为特定 c-types 对象。例如,调用 self._as_parameter_ 等效于 self.data_as(ctypes.c_void_p)。也许您想将数据用作指向浮点数据 ctypes 数组的指针:self.data_as(ctypes.POINTER(ctypes.c_double))

返回的指针将保留对数组的引用。

_ctypes.shape_as(obj)[source]

返回形状元组,作为其他 c-types 类型的数组。例如:self.shape_as(ctypes.c_short)

_ctypes.strides_as(obj)[source]

返回步长元组,作为其他 c-types 类型的数组。例如:self.strides_as(ctypes.c_longlong)

如果 ctypes 模块不可用,则数组对象的 ctypes 属性仍返回有用的内容,但不会返回 ctypes 对象,并可能引发错误。特别是,该对象仍将具有 as_parameter 属性,它将返回一个等于 data 属性的整数。

示例

>>> import numpy as np
>>> import ctypes
>>> x = np.array([[0, 1], [2, 3]], dtype=np.int32)
>>> x
array([[0, 1],
       [2, 3]], dtype=int32)
>>> x.ctypes.data
31962608 # may vary
>>> x.ctypes.data_as(ctypes.POINTER(ctypes.c_uint32))
<__main__.LP_c_uint object at 0x7ff2fc1fc200> # may vary
>>> x.ctypes.data_as(ctypes.POINTER(ctypes.c_uint32)).contents
c_uint(0)
>>> x.ctypes.data_as(ctypes.POINTER(ctypes.c_uint64)).contents
c_ulong(4294967296)
>>> x.ctypes.shape
<numpy._core._internal.c_long_Array_2 object at 0x7ff2fc1fce60> # may vary
>>> x.ctypes.strides
<numpy._core._internal.c_long_Array_2 object at 0x7ff2fc1ff320> # may vary