z ilD8SrSSKJr SrSSKrSSKJrJrJrJ r J r J r J r J r SSKJrJr SSKJrJr SSKJr S S KJrJrJr S S KJr S S KJrJrJr \ (aSS KJ r "SS5r!\!"5r""SS\5r#"SS\5r$"SS5r%"SS5r&g)zselfs `/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/controlflow/switch_case.py__repr___DefaultCaseType.__repr__+sr!N)__name__ __module__ __qualname____firstlineno____doc__r%__static_attributes__r!r'r$rr"s C  r'rcx^\rSrSrSrSS.S U4SjjjrU4SjrS SjrSr\ S 5r SS jr S r U=r $)r2zA circuit operation that executes one particular circuit block based on matching a given ``target`` against an ordered list of ``values``. The special value :data:`.CASE_DEFAULT` can be used to represent a default condition. Nlabelc l>SSKJn [U[R5(aRUR R [R[R4;a[SUR S35eO&[U[[45(d [S5e[U[R5(a@UR R [RLaSOUR RnO"[U[5(aSO [U5nSU-S- n[5nSupXl0Ul/Ul/Ul[)U5GHun up[U [*[,45(a [+U 5OU 4n U HnXR";a[SU35e[.UR";a [S 5eU[.LaC[U[05(aUS:a [S 5eX:a[S US US USUS3 5eXR"U'M UR$R3U 5 [X5(d [S5e[5U 5U;a [S5eUR7[5U 55 UcU R8U R:pU R8U:wdU R:U :wa [S5eUR&R3U 5 GM UR&(d [S5e[<TU]}SXUR&US9 g)a Args: target: the real-time value to switch on. cases: an ordered iterable of the corresponding value of the ``target`` and the circuit block that should be executed if this is matched. There is no fall-through between blocks, and the order matters. rrzNthe switch target must be an expression with type 'Uint(n)' or 'Bool()', not ''z5the switch target must be a classical bit or registerr)NNzduplicate case value z'cases after the default are unreachablez5case values must be Booleans or non-negative integerszswitch target 'z' has z bit(s) of precision, but case z is larger than the maximum of .z,case blocks must be QuantumCircuit instancesz.ungrouped cases cannot point to the same blockNzincompatible bits between casesz"must have at least one case to run switch_caser0) qiskit.circuitr isinstancerExprtypekindrUintBoolrrrwidthlensettarget _case_map _label_spec_params enumeratetuplelistrintappendidadd num_qubits num_clbitssuper__init__)r#r@casesr1r target_bits target_maxcase_idsrKrLi value_speccase_valuesvalue __class__s r$rNSwitchCaseOp.__init__8s 2 fdii ( ({{ EJJ'??"#[[M,@ FU,=$>??VW W fdii ( (%{{//5::=!6;;CTCTK)&%88!c&kK;&!+ 5!+   &QS   S'0&6 "A" *4Z%*O*OU:&V`UbFNN*&)>ug'FGG4>>1&'PQQ ,%eS11UQY*+bcc)*-fXVK=I))./NzlZ[])*u%     # #F +e44"#QRR%yH$"#STT LLE #!).)9)95;K;KJ:-1A1AZ1O"#DEE LL   &5'76||CD D   TYZr'c>[TU]U5=(aP URUR:H=(a0 [S[ UR UR 555$)Nc3T# UHup[U5[U5:Hv M g7fN)r?).0 labels_self labels_others r$ &SwitchCaseOp.__eq__..s)1Y-KK C $551Ys&()rM__eq__r@allziprB)r#otherrXs r$rbSwitchCaseOp.__eq__sX GN5 !  u||+ 14T5E5EuGXGX1Y r'cB[URUR5$)aReturn an iterable where each element is a 2-tuple whose first element is a tuple of jump values, and whose second is the single circuit block that is associated with those values. This is an abstract specification of the jump table suitable for creating new :class:`.SwitchCaseOp` instances. .. seealso:: :meth:`.SwitchCaseOp.cases` Create a lookup table that you can use for your own purposes to jump from values to the circuit that would be executed.)rdrBrCr"s r$cases_specifierSwitchCaseOp.cases_specifiers4##T\\22r'cURR5VVs0sHupXRU_M snn$s snnf)aReturn a lookup table from case labels to the circuit that would be executed in that case. This object is not generally suitable for creating a new :class:`.SwitchCaseOp` because any keys that point to the same object will not be grouped. .. seealso:: :meth:`.SwitchCaseOp.cases_specifier` An alternate method that produces its output in a suitable format for creating new :class:`.SwitchCaseOp` instances. )rAitemsrC)r#keyindexs r$rOSwitchCaseOp.casess:<@>>;O;O;QR;QZS\\%((;QRRRs=c,[UR5$r\)rErCr"s r$blocksSwitchCaseOp.blockssT\\""r'c [U5n[U5[UR5:wa-[S[UR5S[U535e[ UR [URU55$)Nzneeded z blocks but received ) rEr>rCrrArr@rdrB)r#rps r$replace_blocksSwitchCaseOp.replace_blockssiv v;#dll+ +T^^)<(==RSVW]S^R_`a aDKKT-=-=v)FGGr')rArBrCr@)r@%Clbit | ClassicalRegister | expr.ExprrOz$Iterable[Tuple[Any, QuantumCircuit]]r1 Optional[str])returnz&Iterable[Tuple[Tuple, QuantumCircuit]])rpzIterable[QuantumCircuit]rwz'SwitchCaseOp')r(r)r*r+r,rNrbrhrOpropertyrprsr- __classcell__rXs@r$rr2sn $ O[5O[4O[  O[O[b   3 S##HHr'rcT^\rSrSrSrSS.S U4SjjjrSrSrSrS r U=r $) SwitchCasePlaceholderaA placeholder instruction to use in control-flow context managers, when calculating the number of resources this instruction should block is deferred until the construction of the outer loop. This generally should not be instantiated manually; only :obj:`.SwitchContext` should do it when it needs to defer creation of the concrete instruction. .. warning:: This is an internal interface and no part of it should be relied upon outside of Qiskit Terra. Nr0c>XlX lUR5Ul[TU]S[ URR5[ URR5/US9 g)Nr5r0) _SwitchCasePlaceholder__target_SwitchCasePlaceholder__cases _calculate_placeholder_resources!_SwitchCasePlaceholder__resourcesrMrNr>qubitsclbits)r#r@rOr1rXs r$rNSwitchCasePlaceholder.__init__sc  @@B     '' (   '' (   r'c[5n[5n[5n[5n[UR[5(aUR UR5 O[UR[ 5(a7UR UR5 UR UR5 OK[UR5nUR UR5 UR UR5 URHHupgXR5-nX'R5-n[UR5upX8-nXI-nMJ [[U5[U5[U5[U5S9$)Nrrqregscregs)r?r7rrrJrupdaterrrrrr registersrrE) r#rrrr resources_body body_qregs body_cregss r$r6SwitchCasePlaceholder._calculate_placeholder_resourcess dmmU + + JJt}} %  '8 9 9 MM$-- ( IIdmm $&t}}5I MM)** + LL )||GA kkm #F kkm #F%8%H "J  E  E $ $==,,   r'cUR$r\)rr"s r$placeholder_resources+SwitchCasePlaceholder.placeholder_resourcessr'c ^^[UR[UU4SjUR555VVVs/sH uup4nX54PM nnnnU(aq[[ USSR 5[ USSR 5[ USSR5[ USSR5S9nO URn[URX`RS9U4$s snnnf)Nc3L># UHupURTT5v M g7fr\)build)r]rrrrs r$r`=SwitchCasePlaceholder.concrete_instruction..s#'_R^wq 66(B(BR^s!$rrrr0) rdrrrrErrrrrrrr1)r#rrlabelsr unified_bodyrOrs `` r$concrete_instruction*SwitchCasePlaceholder.concrete_instructions.1 ''_RVR^R^'__. .) \ ".   ,U1Xa[//0U1Xa[//0E!HQK--.E!HQK--. I((I ZZ @   ! sC5)__cases __resources__target)r@rurOz)List[Tuple[Any, ControlFlowBuilderBlock]]r1rv) r(r)r*r+r,rNrrrr-ryrzs@r$r|r|sG $ $  5 9    $ 6   r'r|c\\rSrSrSrSS.S SjjrSrS SjrSrS r S r g) SwitchContextiaSA context manager for building up ``switch`` statements onto circuits in a natural order, without having to construct the case bodies first. The return value of this context manager can be used within the created context to build up the individual ``case`` statements. No other instructions should be appended to the circuit during the `switch` context. This context should almost invariably be created by a :meth:`.QuantumCircuit.switch_case` call, and the resulting instance is a "friend" of the calling circuit. The context will manipulate the circuit's defined scopes when it is entered (by pushing a new scope onto the stack) and exited (by popping its scope, building it, and appending the resulting :obj:`.SwitchCaseOp`). .. warning:: This is an internal interface and no part of it should be relied upon outside of Qiskit Terra. Nr0cnXlX l[U[5(aU4UlSUlO[[U[ 5(a[U5UlU4UlO-[U5nURUlURUlX0l SUl X@l /Ul[5Ulg)Nr!F)circuit_targetr7r target_clbits target_cregsrrErrrin_loopcomplete _op_label_casesr? _label_set)r#rr@rr1rs r$rNSwitchContext.__init__"s  fe $ $5;ID ?AD   1 2 2!&vD !' D &v.I!*!1!1D  )D   MO %r'cXR;$)zMReturn whether a case label is already accounted for in the switch statement.)r)r#r1s r$ label_in_useSwitchContext.label_in_use<s''r'crURRU5 URRX45 g)zAdd a sequence of conditions and the single block that should be run if they are triggered to the context. The labels are assumed to have already been validated using :meth:`label_in_use`.N)rrrrH)r#rblocks r$add_caseSwitchContext.add_case@s* v& F?+r'cJURRSS9 [U5$)Nz'Cannot have instructions outside a case)forbidden_message)r _push_scope CaseBuilderr"s r$ __enter__SwitchContext.__enter__Ks#   3\ ]4  r'cSUlURR5 Ubg[URUR UR S9nUR5nUR(a1URRXERUR5 gUR[UR5[UR55upgURRXgRUR5 g)NTFr0)rr _pop_scoper|rrrrrrHrrrr?)r#exc_typeexc_valexc_tb placeholderinitial_resources operationrs r$__exit__SwitchContext.__exit__Os  !  ,DLL$++T^^\ '==? << LL   -E-EGXG_G_ `  $/#C#C%,,-s3D3K3K/L$ I LL   +;+;Y=M=M Nr') rrrrrrrrr)rrr@rurboolr1rv)rz-Tuple[Union[int, Literal[CASE_DEFAULT]], ...]rr) r(r)r*r+r,rNrrrrr-r!r'r$rrs[0 $   6     4( ,C ,Lc ,!r'rcL\rSrSrSr\rSSjr\RS5r Sr g)ridaA child context manager for building up the ``case`` blocks of ``switch`` statements onto circuits in a natural order, without having to construct the case bodies first. This context should never need to be created manually by a user; it is the return value of the :class:`.SwitchContext` context manager, which in turn should only be created by suitable :meth:`.QuantumCircuit.switch_case` calls. .. warning:: This is an internal interface and no part of it should be relied upon outside of Qiskit Terra. cXlSUlg)NF)switchentered)r#parents r$rNCaseBuilder.__init__us  r'c'J# UR(a [S5eURR(a [S5e[ SU55(d [S5e[ 5nUHHnURR U5(dX2;a[SUS35eURU5 MJ URRRURRURRURRS9 SUlSv S UlURRR5nURRX5 g!S UlURRR5nf=f7f) NzCannot enter more than one case at once. If you want multiple labels to point to the same block, pass them all to a single case context, such as `with case(1, 2, 3):`.z6Cannot add a new case to a completed switch statement.c3^# UH#o[L=(d [U[5v M% g7fr\)rr7rG)r]rWs r$r`'CaseBuilder.__call__..s$WPVuL(BJuc,BBPVs+-z.Case values must be integers or `CASE_DEFAULT`zduplicate case label: 'r3)rr allow_jumpsTF)rrrrrcr?rrJrrrrrrr)r#rVseenrWrs r$__call__CaseBuilder.__call__ysK <<2  ;;  WX XWPVWWWOP PuE{{''..%-"%rsC" *VVV302ZZ'XX-    ! EH=EHPR 2R jRRj7,7,r'