cuquantum.custatevec.swap_index_bits

cuquantum.custatevec.swap_index_bits(intptr_t handle, intptr_t sv, int sv_data_type, uint32_t n_index_bits, swapped_bits, uint32_t n_swapped_bits, mask_bit_string, mask_ordering, uint32_t mask_len)[源代码]

在设备上交换索引位并重新排序状态向量元素。

参数
  • handle (intptr_t) – 库句柄。

  • sv (intptr_t) – 指向状态向量(在设备上)的指针地址(作为 Python int)。

  • sv_data_type (cuquantum.cudaDataType) – 状态向量的数据类型。

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

  • swapped_bits

    交换索引位对的主机数组。它可以是

    • 作为指向嵌套序列的指针地址的 int

    • 交换索引位的嵌套 Python 序列

  • n_swapped_bits (uint32_t) – 交换索引位对的数量。

  • mask_bit_string

    用于指定掩码值的主机数组。它可以是

    • 作为指向数组的指针地址的 int

    • 掩码值的 Python 序列

  • mask_ordering

    掩码顺序的主机数组。它可以是

    • 作为指向数组的指针地址的 int

    • 索引位顺序的 Python 序列

  • mask_len (uint32_t) – mask_ordering 的长度。