QkClassicalRegister

typedef struct QkClassicalRegister QkClassicalRegister

Uma maneira comum de instanciar vários bits de uma vez é criar um registro. Um registro é um conjunto nomeado de bits. A criação de um registro permite dar a uma coleção de bits um nome que pode ser usado como metadados em torno de bits específicos em um circuito. Normalmente, esse nome também será preservado ao exportar o circuito para idiomas de intercâmbio.

É possível criar um registro chamando qk_classical_register_new(), por exemplo:

#include <qiskit.h>

QkClassicalRegister *creg = qk_classical_register_new(5, "my_creg");

Isso cria um novo registro clássico de 5 bits chamado "my_creg".

Em seguida, para adicionar o registro a um circuito, use a função qk_circuit_add_classical_register() :

QkCircuit *qc = qk_circuit_new(0, 0);
qk_circuit_add_classical_register(qc, creg);
uint32_t num_qubits = qk_circuit_num_qubits(qc); // 5

Embora os circuitos rastreiem os registros, os próprios registros quase não transmitem diferenças de comportamento aos circuitos.

Funções

qk_classical_register_free

void qk_classical_register_free(QkClassicalRegister *reg)

Registro clássico gratuito.

Exemplo

QkClassicalRegister *cr = qk_classical_register_new(1024, "creg");
qk_classical_register_free(cr);

Segurança

O comportamento é indefinido se reg não for nulo ou um ponteiro válido para QkClassicalRegister.

Parâmetros

reg - Um ponteiro para o registro a ser liberado.

qk_classical_register_new

QkClassicalRegister *qk_classical_register_new(uint32_t num_clbits, const char *name)

Construa um novo registro clássico proprietário com um determinado número de clbits e nome

Exemplo

QkClassicalRegister *cr = qk_classical_register_new(5, "five_qubits");

Segurança

O parâmetro name deve ser um ponteiro para a memória que contenha um terminador nul válido no final da cadeia de caracteres. Ele também deve ser válido para leituras de bytes até o terminador nul, inclusive.

Parâmetros

num_clbits - O número de clbits para criar o registro
name - A cadeia de caracteres do nome do registro criado. O nome deve ser composto de caracteres válidos em UTF-8.

Retorna

Um ponteiro para o registro criado

Esta página foi útil?

Relate um bug, erro de digitação ou solicite conteúdo no GitHub.