Versionssteuerung

Eine für Menschen lesbare Version als char*. Beispiel: "2.1.0-rc1".

Die Versionsnummer als 4-Byte-Hexadezimalzahl. Das Format lautet 0xMMmmppls, wobei die Hauptversion, die Nebenversion, der Patch M , die m``p Release-Stufe und l die s Seriennummer ist. Zum Beispiel ist 2.1.0-rc10x020100C1.

Beachten Sie, dass endgültige Versionen, wie z. B. 2.1.0, im letzten 0xF0 Byte immer mit enden.

Die Laufzeitversion davon finden qk_api_version() Sie hier.

Die Hauptversionsnummer.

Die kleinere Release-Version.

Die Version der Patch-Freigabe.

Die Freigabestufe:

• 0xA für eine noch nicht veröffentlichte Entwickler- (oder Alpha-)Version
• 0xB für eine Beta-Version
• 0xC als Release Candidate
• 0xF für eine stabile (oder endgültige) Version.

Dies kann verwendet werden, um die Nummer einer Vorabversion innerhalb einer Vorabversionsreihe anzugeben. Dies würde beispielsweise für 4 auf 2.1.0-rc4gesetzt werden. Dies gilt 0 für die endgültige Fassung.

Ein Makro, um die Versionsnummern in das hexadezimale Format zu packen. Dies kann als Werkzeug verwendet werden, um Zahlen zu vergleichen, z.B. um sicherzustellen, dass die aktuelle Version mindestens der stabilen 2.1.0 Version entspricht:

if (QISKIT_VERSION_HEX >= QISKIT_GET_VERSION_HEX(2, 1, 0, 0xF, 0)) {
    // Code for version 2.1.0 (final) or later
}

uint32_t qk_api_version(void)

Rufe die C-API-Version der geladenen Bibliothek ab.

Wenn Sie eine dynamische Verknüpfung mit Qiskit herstellen, sei es in einer eigenständigen oder einer „ Python “-Erweiterung, kann diese Funktion nützlich sein, um die Version der Bibliothek zu überprüfen, die zur Laufzeit tatsächlich geladen ist. Das Makro in der Header-Datei entspricht QISKIT_VERSION_HEX dieser Funktion, gilt jedoch für die Version der Header, die zum Zeitpunkt der Kompilierung verwendet wird.

Rückgabe

Die Version der kompilierten Qiskit-C-API-Bibliothek, im gleichen Format wie das QISKIT_VERSION_HEX Header-Datei-Makro.