Many-not gates

Functions for effecting many-qubit NOT gates. More...

Functions
void	applyControlledMultiQubitNot (Qureg qureg, int control, int *targets, int numTargets)
void	applyControlledMultiQubitNot (Qureg qureg, int control, std::vector< int > targets)
void	applyMultiControlledMultiQubitNot (Qureg qureg, int *controls, int numControls, int *targets, int numTargets)
void	applyMultiControlledMultiQubitNot (Qureg qureg, std::vector< int > controls, std::vector< int > targets)
void	applyMultiQubitNot (Qureg qureg, int *targets, int numTargets)
void	applyMultiQubitNot (Qureg qureg, std::vector< int > targets)
void	applyMultiStateControlledMultiQubitNot (Qureg qureg, int *controls, int *states, int numControls, int *targets, int numTargets)
void	applyMultiStateControlledMultiQubitNot (Qureg qureg, std::vector< int > controls, std::vector< int > states, std::vector< int > targets)
void	multiplyMultiQubitNot (Qureg qureg, int *targets, int numTargets)
void	multiplyMultiQubitNot (Qureg qureg, std::vector< int > targets)

Detailed Description

Functions for effecting many-qubit NOT gates.

Function Documentation

applyControlledMultiQubitNot() [1/2]

void applyControlledMultiQubitNot	(	Qureg	qureg,
		int	control,
		int *	targets,
		int	numTargets )

Note

Documentation for this function or struct is under construction!

Definition at line 1674 of file operations.cpp.

                                                                                          {
    validate_quregFields(qureg, __func__);
    validate_controlAndTargets(qureg, control, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledMultiQubitNot(qureg, &control, nullptr, 1, targets, numTargets);
}

Referenced by applyControlledMultiQubitNot().

applyControlledMultiQubitNot() [2/2]

void applyControlledMultiQubitNot	(	Qureg	qureg,
		int	control,
		std::vector< int >	targets )

Warning

This function has not yet been unit tested and may contain bugs. Please use with caution!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

Definition at line 1714 of file operations.cpp.

                                                                                 {
 
    applyControlledMultiQubitNot(qureg, control, targets.data(), targets.size());
}

applyMultiControlledMultiQubitNot() [1/2]

void applyMultiControlledMultiQubitNot	(	Qureg	qureg,
		int *	controls,
		int	numControls,
		int *	targets,
		int	numTargets )

Note

Documentation for this function or struct is under construction!

Definition at line 1682 of file operations.cpp.

                                                                                                                  {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTargets(qureg, controls, numControls, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledMultiQubitNot(qureg, controls, nullptr, numControls, targets, numTargets);
}

Referenced by applyMultiControlledMultiQubitNot().

applyMultiControlledMultiQubitNot() [2/2]

void applyMultiControlledMultiQubitNot	(	Qureg	qureg,
		std::vector< int >	controls,
		std::vector< int >	targets )

Warning

This function has not yet been unit tested and may contain bugs. Please use with caution!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

Definition at line 1719 of file operations.cpp.

                                                                                               {
 
    applyMultiControlledMultiQubitNot(qureg, controls.data(), controls.size(), targets.data(), targets.size());
}

applyMultiQubitNot() [1/2]

void applyMultiQubitNot	(	Qureg	qureg,
		int *	targets,
		int	numTargets )

Note

Documentation for this function or struct is under construction!

Definition at line 1666 of file operations.cpp.

                                                                   {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    // harmlessly re-validates
    applyMultiStateControlledMultiQubitNot(qureg, nullptr, nullptr, 0, targets, numTargets);
}

Referenced by applyMultiQubitNot().

applyMultiQubitNot() [2/2]

void applyMultiQubitNot	(	Qureg	qureg,
		std::vector< int >	targets )

Warning

This function has not yet been unit tested and may contain bugs. Please use with caution!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

Definition at line 1709 of file operations.cpp.

                                                          {
 
    applyMultiQubitNot(qureg, targets.data(), targets.size());
}

applyMultiStateControlledMultiQubitNot() [1/2]

void applyMultiStateControlledMultiQubitNot	(	Qureg	qureg,
		int *	controls,
		int *	states,
		int	numControls,
		int *	targets,
		int	numTargets )

Note

Documentation for this function or struct is under construction!

Definition at line 1690 of file operations.cpp.

                                                                                                                                    {
    validate_quregFields(qureg, __func__);
    validate_controlsAndTargets(qureg, controls, numControls, targets, numTargets, __func__);
    validate_controlStates(states, numControls, __func__);
 
    // treat as an all-X PauliStr
    PauliStr str = getPauliStr(std::string(numTargets, 'X'), targets, numTargets);
 
    // harmlessly re-validates
    applyMultiStateControlledPauliStr(qureg, controls, states, numControls, str);
}

Referenced by applyControlledMultiQubitNot(), applyMultiControlledMultiQubitNot(), applyMultiQubitNot(), and applyMultiStateControlledMultiQubitNot().

applyMultiStateControlledMultiQubitNot() [2/2]

void applyMultiStateControlledMultiQubitNot	(	Qureg	qureg,
		std::vector< int >	controls,
		std::vector< int >	states,
		std::vector< int >	targets )

Warning

This function has not yet been unit tested and may contain bugs. Please use with caution!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

Definition at line 1724 of file operations.cpp.

                                                                                                                        {
    validate_controlsMatchStates(controls.size(), states.size(), __func__);
 
    applyMultiStateControlledMultiQubitNot(qureg, controls.data(), states.data(), controls.size(), targets.data(), targets.size());
}

multiplyMultiQubitNot() [1/2]

void multiplyMultiQubitNot	(	Qureg	qureg,
		int *	targets,
		int	numTargets )

Note

Documentation for this function or struct is under construction!

Definition at line 1658 of file operations.cpp.

                                                                      {
    validate_quregFields(qureg, __func__);
    validate_targets(qureg, targets, numTargets, __func__);
 
    // harmlessly re-validates
    multiplyPauliStr(qureg, getPauliStr(std::string(numTargets, 'X'), targets, numTargets));
}

Referenced by multiplyMultiQubitNot().

multiplyMultiQubitNot() [2/2]

void multiplyMultiQubitNot	(	Qureg	qureg,
		std::vector< int >	targets )

Warning

This function has not yet been unit tested and may contain bugs. Please use with caution!

Attention

This function's input validation has not yet been unit tested, so erroneous usage may produce unexpected output. Please use with caution!

Note

Documentation for this function or struct is under construction!

Remarks

This function is only available in C++.

Definition at line 1704 of file operations.cpp.

                                                             {
 
    multiplyMultiQubitNot(qureg, targets.data(), targets.size());
}