Interfaz de la API C de Python
qiskit.capi
Este módulo permite la interacción entre el espacio de « Python » y la API pública en C de Qiskit.
Para consultar la documentación sobre la propia API de C, véase la API de C de Qiskit.
Interacción con el sistema de compilación
El paquete « Pythonqiskit » contiene todos los archivos de encabezado de la API de Qiskit en C, así como una biblioteca de objetos compartidos compilada que incluye todas las funciones de la API de C. Puedes acceder a la ubicación de estos dos objetos mediante las funciones get_include() y get_lib() respectivamente.
Por lo general, no se debe vincular directamente con la salida de get_lib(), a menos que se sepa lo que se está haciendo. En concreto, la vinculación directa con este objeto no es una forma segura de crear un módulo de extensión distribuible de Python que utilice la API en C de Qiskit.
Sin embargo, si conoces todas las limitaciones de la vinculación directa, puedes utilizar esta función para obtener la ubicación de la biblioteca.
get_include
qiskit.capi.get_include()
Consigue el directorio que contiene el archivo de qiskit.h encabezado C y los archivos auxiliares qiskit/*.h internos.
Cuando se utiliza Qiskit como dependencia de compilación, lo habitual es incluir este directorio en la ruta de búsqueda de archivos de inclusión del compilador, por ejemplo:
qiskit_include=$(python -c 'import qiskit.capi; print(qiskit.capi.get_include())')
gcc -I "$qiskit_include" my_bin.c -o my_binLa ubicación de este directorio dentro de los datos del paquete Qiskit no es fija y puede variar entre las distintas versiones de Qiskit. Siempre debes utilizar esta función para recuperar el directorio.
Devuelve
una ruta absoluta al directorio de archivos de inclusión del paquete.
Tipo de retorno
get_lib
qiskit.capi.get_lib()
Obtén la ruta de acceso a una biblioteca de objetos compartidos que contenga todos los símbolos exportados de la API de C.
Por lo general*, no* se debe vincular directamente con este objeto. En concreto, vincular directamente este objeto no es una forma segura de crear un módulo de extensión de Python que utilice la API en C de Qiskit.
Si lo deseas, puedes utilizar ctypes para acceder a los símbolos de la API de C que contiene este objeto, aunque ten en cuenta que los tipos de la API de C declarados en el archivo de cabecera no son intercambiables con los objetos de Python que les corresponden.
La ubicación y el nombre de este archivo dentro de los datos del paquete Qiskit no son fijos y pueden variar entre las distintas versiones de Qiskit.
Devuelve
una ruta absoluta a la biblioteca de objetos compartidos que contiene los símbolos exportados de la API de C.
Tipo de retorno