Program.inst¶

Program.inst(*instructions)[source]¶

Mutates the Program object by appending new instructions.

This function accepts a number of different valid forms, e.g.

>>> p = Program()
>>> p.inst(H(0)) # A single instruction
>>> p.inst(H(0), H(1)) # Multiple instructions
>>> p.inst([H(0), H(1)]) # A list of instructions
>>> p.inst(H(i) for i in range(4)) # A generator of instructions
>>> p.inst(("H", 1)) # A tuple representing an instruction
>>> p.inst("H 0") # A string representing an instruction
>>> q = Program()
>>> p.inst(q) # Another program

It can also be chained:

>>> p = Program()
>>> p.inst(H(0)).inst(H(1))

Parameters: instructions (Union[AbstractInstruction, DefGate, Program, List[Any], Tuple[Any, …], str, Generator[Any, Any, Any]]) – A list of Instruction objects, e.g. Gates
Return type: Program
Returns: self for method chaining