DumpRegister-Funktion

Warnung

Diese Dokumentation bezieht sich auf das klassische QDK, das durch das moderne QDK ersetzt wurde.

Weitere Informationen finden https://aka.ms/qdk.api Sie in der API-Dokumentation für das moderne QDK.

Namespace: Microsoft.Quantum.Diagnostics

Paket: Microsoft.Quantum.QSharp.Foundation

Gibt die status des aktuellen Zielcomputers ab, die den angegebenen Qubits zugeordnet sind.

function DumpRegister<'T> (location : 'T, qubits : Qubit[]) : Unit

Eingabe

Location : 'T

Enthält Informationen dazu, wo das Speicherabbild des Zustands generiert werden soll.

Qubits: Qubit[]

Die Liste der zu meldenden Qubits.

Ausgabe: Einheit

Typparameter

'T

Beispiel

Wenn sie im Vollzustandssimulator ausgeführt wird, wird mit dem folgenden Codeausschnitt der Bell-Zustand $(\ket{00} + \ket{11}) / \sqrt{2}$ in der Konsole abspeichert:

use left = Qubit();
use right = Qubit();
within {
    H(left);
    CNOT(left, right);
} apply {
    // The () input here denotes that the state dumped by the
    // full-state simulator should be reported to the console.
    DumpRegister((), [left, right]);
}

Hinweise

Mit dieser Methode können Sie die Informationen, die dem Zustand der angegebenen Qubits zugeordnet sind, in einer Datei oder an einem anderen Speicherort speichern. Die tatsächlich generierten Informationen und die Semantik von location sind für jeden Zielcomputer spezifisch. Die Bereitstellung eines leeren Tupels als Speicherort (()) bedeutet jedoch in der Regel, die Ausgabe an die Konsole zu generieren.

Für den lokalen Vollzustandssimulator, der als Teil des Quantum Development Kit verteilt wird, erwartet diese Methode eine Zeichenfolge mit dem Pfad zu einer Datei, in der sie den Zustand der angegebenen Qubits (d. h. die Wellenfunktion des entsprechenden Subsystems) als eindimensionales Array komplexer Zahlen schreibt, in dem jedes Element die Amplituden der Wahrscheinlichkeit der Messung des entsprechenden Zustands darstellt. Wenn die angegebenen Qubits mit einem anderen Qubit verschränkt sind und ihr Zustand nicht getrennt werden kann, wird lediglich gemeldet, dass die Qubits verschränkt sind.