pub unsafe extern "C" fn initPureState(qureg: Qureg, pure_: Qureg)Expand description
Initialise \p qureg into to a given pure state of an equivalent Hilbert dimension.
If \p qureg is a state-vector, this merely clones \p pure into \p qureg. \n If \p qureg is a density matrix, this makes \p qureg 100% likely to be in the \p pure state.
::Qureg \p pure is not modified.
@see
- initClassicalState()
@ingroup init @param[in,out] qureg the ::Qureg to modify @param[in] pure a state-vector containing the pure state into which to initialise \p qureg @throws invalidQuESTInputError()
- if \p qureg and \p pure have mismatching dimensions
- if \p pure is a density matrix @author Tyson Jones