cuquantum.custatevec.accessor_create

cuquantum.custatevec.accessor_create(intptr_t handle, intptr_t sv, int sv_data_type, uint32_t n_index_bits, bit_ordering, uint32_t bit_ordering_len, mask_bit_string, mask_ordering, uint32_t mask_len) → tuple

创建访问器以在状态向量和外部缓冲区之间复制元素。

参数

• handle (intptr_t) – cuStateVec 库的句柄。

• sv (intptr_t) – 状态向量。

• sv_data_type (int) – 状态向量的数据类型。

• n_index_bits (uint32_t) – 状态向量的索引位数。

• bit_ordering (object) –

  指向主机数组的指针，用于指定外部缓冲区的基位。它可以是

  • 一个 int 作为数组的指针地址，或

  • 一个 int32_t 的 Python 序列。

• bit_ordering_len (uint32_t) – bit_ordering 的长度。

• mask_bit_string (object) –

  指向主机数组的指针，用于指定掩码值以限制访问。它可以是

  • 一个 int 作为数组的指针地址，或

  • 一个 int32_t 的 Python 序列。

• mask_ordering (object) –

  用于掩码排序的主机数组的指针。它可以是

  • 一个 int 作为数组的指针地址，或

  • 一个 int32_t 的 Python 序列。

• mask_len (uint32_t) – 掩码的长度。

返回

• intptr_t: 指向访问器描述符的指针。

• size_t: 所需的额外工作区大小。

返回类型

包含以下内容的 2 元组

参见

custatevecAccessorCreate()