qsharp-lang 1.1.2-dev → 1.1.4-dev

package/docs/Microsoft.Quantum.Random/DrawRandomInt.md

@@ -0,0 +1,40 @@
+---
+uid: Microsoft.Quantum.Random.DrawRandomInt
+title: DrawRandomInt operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Random
+qsharp.name: DrawRandomInt
+qsharp.summary: Draws a random integer in a given inclusive range.
+---
+
+# DrawRandomInt operation
+
+Namespace: [Microsoft.Quantum.Random](xref:Microsoft.Quantum.Random)
+
+```qsharp
+operation DrawRandomInt(min : Int, max : Int) : Int
+```
+
+## Summary
+Draws a random integer in a given inclusive range.
+
+## Input
+### min
+The smallest integer to be drawn.
+### max
+The largest integer to be drawn.
+
+## Output
+An integer in the inclusive range from `min` to `max` with uniform
+probability.
+
+## Remarks
+Fails if `max < min`.
+
+## Example
+The following Q# snippet randomly rolls a six-sided die:
+```qsharp
+let roll = DrawRandomInt(1, 6);
+```

package/docs/Microsoft.Quantum.ResourceEstimation/AccountForEstimates.md

@@ -0,0 +1,35 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.AccountForEstimates
+title: AccountForEstimates operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: AccountForEstimates
+qsharp.summary: Account for the resource estimates of an unimplemented operation,
+which were obtained separately. This operation is only available
+when using resource estimator execution target.
+---
+
+# AccountForEstimates operation
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+operation AccountForEstimates(estimates : (Int, Int)[], layout : Int, arguments : Qubit[]) : Unit is Adj
+```
+
+## Summary
+Account for the resource estimates of an unimplemented operation,
+which were obtained separately. This operation is only available
+when using resource estimator execution target.
+## Input
+### cost
+Array of tuples containing resource estimates of the operation. For example,
+if the operation uses three T gates, pass the tuple returned by TCount(3)
+as one of the array elements.
+### layout
+Provides the layout scheme that is used to convert logical resource estimates
+to physical resource estimates. Only PSSPCLayout() is supported at this time.
+### arguments
+Operation takes these qubits as its arguments.

package/docs/Microsoft.Quantum.ResourceEstimation/AuxQubitCount.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.AuxQubitCount
+title: AuxQubitCount function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: AuxQubitCount
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of auxiliary qubits is equal to the `amount`.
+---
+
+# AuxQubitCount function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function AuxQubitCount(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of auxiliary qubits is equal to the `amount`.

package/docs/Microsoft.Quantum.ResourceEstimation/BeginEstimateCaching.md

@@ -0,0 +1,39 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.BeginEstimateCaching
+title: BeginEstimateCaching function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: BeginEstimateCaching
+qsharp.summary: Informs the resource estimator of the start of the code fragment
+for which estimates caching can be done. This function
+is only available when using resource estimator execution target.
+---
+
+# BeginEstimateCaching function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function BeginEstimateCaching(name : String, variant : Int) : Bool
+```
+
+## Summary
+Informs the resource estimator of the start of the code fragment
+for which estimates caching can be done. This function
+is only available when using resource estimator execution target.
+
+## Input
+### name
+The name of the code fragment. Used to distinguish it from other code fragments.
+Typically this is the name of the operation for which estimates can be cached.
+### variant
+Specific variant of the execution. Cached estimates can only be reused if the
+variant for which they were collected and the current variant is the same.
+
+## Output
+`true` indicated that the cached estimates are not yet available and the code fragment
+needs to be executed in order to collect and cache estimates.
+`false` indicates if cached estimates have been incorporated into the overall costs
+and the code fragment should be skipped.

package/docs/Microsoft.Quantum.ResourceEstimation/BeginRepeatEstimates.md

@@ -0,0 +1,36 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.BeginRepeatEstimates
+title: BeginRepeatEstimates operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: BeginRepeatEstimates
+qsharp.summary: Instructs the resource estimator to assume that the resources from the
+call of this operation until a call to `EndRepeatEstimates` are
+accounted for `count` times, without the need to execute the code that many
+times. Calls to `BeginRepeatEstimates` and `EndRepeatEstimates` can be nested.
+A helper operation `RepeatEstimates` allows to call the two functions in a
+`within` block.
+---
+
+# BeginRepeatEstimates operation
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+operation BeginRepeatEstimates(count : Int) : Unit is Adj
+```
+
+## Summary
+
+Instructs the resource estimator to assume that the resources from the
+call of this operation until a call to `EndRepeatEstimates` are
+accounted for `count` times, without the need to execute the code that many
+times. Calls to `BeginRepeatEstimates` and `EndRepeatEstimates` can be nested.
+A helper operation `RepeatEstimates` allows to call the two functions in a
+`within` block.
+
+## Input
+### count
+Assumed number of repetitions, factor to multiply the cost with

package/docs/Microsoft.Quantum.ResourceEstimation/CczCount.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.CczCount
+title: CczCount function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: CczCount
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of the CCZ gates is equal to the `amount`.
+---
+
+# CczCount function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function CczCount(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of the CCZ gates is equal to the `amount`.

package/docs/Microsoft.Quantum.ResourceEstimation/EndEstimateCaching.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.EndEstimateCaching
+title: EndEstimateCaching function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: EndEstimateCaching
+qsharp.summary: Instructs the resource estimator to stop estimates caching
+because the code fragment in consideration is over. This function
+is only available when using resource estimator execution target.
+---
+
+# EndEstimateCaching function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function EndEstimateCaching() : Unit
+```
+
+## Summary
+Instructs the resource estimator to stop estimates caching
+because the code fragment in consideration is over. This function
+is only available when using resource estimator execution target.

package/docs/Microsoft.Quantum.ResourceEstimation/EndRepeatEstimates.md

@@ -0,0 +1,22 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.EndRepeatEstimates
+title: EndRepeatEstimates operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: EndRepeatEstimates
+qsharp.summary: Companion operation to `BeginRepeatEstimates`.
+---
+
+# EndRepeatEstimates operation
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+operation EndRepeatEstimates() : Unit is Adj
+```
+
+## Summary
+
+Companion operation to `BeginRepeatEstimates`.

package/docs/Microsoft.Quantum.ResourceEstimation/MeasurementCount.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.MeasurementCount
+title: MeasurementCount function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: MeasurementCount
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number Measurements is equal to the `amount`.
+---
+
+# MeasurementCount function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function MeasurementCount(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number Measurements is equal to the `amount`.

package/docs/Microsoft.Quantum.ResourceEstimation/PSSPCLayout.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.PSSPCLayout
+title: PSSPCLayout function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: PSSPCLayout
+qsharp.summary: Pass the value returned by the function to the `AccountForEstimates` operation
+to indicate Parallel Synthesis Sequential Pauli Computation (PSSPC) layout.
+See https://arxiv.org/pdf/2211.07629.pdf for details.
+---
+
+# PSSPCLayout function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function PSSPCLayout() : Int
+```
+
+## Summary
+Pass the value returned by the function to the `AccountForEstimates` operation
+to indicate Parallel Synthesis Sequential Pauli Computation (PSSPC) layout.
+See https://arxiv.org/pdf/2211.07629.pdf for details.

package/docs/Microsoft.Quantum.ResourceEstimation/RepeatEstimates.md

@@ -0,0 +1,32 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.RepeatEstimates
+title: RepeatEstimates operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: RepeatEstimates
+qsharp.summary: Instructs the resource estimator to assume that the resources from the
+call of this operation until a call to `Adjoint RepeatEstimates` are
+accounted for `count` times, without the need to execute the code that many
+times.
+---
+
+# RepeatEstimates operation
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+operation RepeatEstimates(count : Int) : Unit is Adj
+```
+
+## Summary
+
+Instructs the resource estimator to assume that the resources from the
+call of this operation until a call to `Adjoint RepeatEstimates` are
+accounted for `count` times, without the need to execute the code that many
+times.
+
+## Input
+### count
+Assumed number of repetitions, factor to multiply the cost with

package/docs/Microsoft.Quantum.ResourceEstimation/RotationCount.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.RotationCount
+title: RotationCount function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: RotationCount
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of rotations is equal to the `amount`.
+---
+
+# RotationCount function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function RotationCount(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of rotations is equal to the `amount`.

package/docs/Microsoft.Quantum.ResourceEstimation/RotationDepth.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.RotationDepth
+title: RotationDepth function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: RotationDepth
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the rotation depth is equal to the `amount`.
+---
+
+# RotationDepth function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function RotationDepth(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the rotation depth is equal to the `amount`.

package/docs/Microsoft.Quantum.ResourceEstimation/SingleVariant.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.SingleVariant
+title: SingleVariant function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: SingleVariant
+qsharp.summary: Used to specify that there's only one execution variant in `BeginEstimateCaching`
+function
+---
+
+# SingleVariant function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function SingleVariant() : Int
+```
+
+## Summary
+Used to specify that there's only one execution variant in `BeginEstimateCaching`
+function

package/docs/Microsoft.Quantum.ResourceEstimation/TCount.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.ResourceEstimation.TCount
+title: TCount function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.ResourceEstimation
+qsharp.name: TCount
+qsharp.summary: Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of the T gates is equal to the `amount`.
+---
+
+# TCount function
+
+Namespace: [Microsoft.Quantum.ResourceEstimation](xref:Microsoft.Quantum.ResourceEstimation)
+
+```qsharp
+function TCount(amount : Int) : (Int, Int)
+```
+
+## Summary
+Returns a tuple that can be passed to the `AccountForEstimates` operation
+to specify that the number of the T gates is equal to the `amount`.

package/docs/Microsoft.Quantum.Unstable.Arithmetic/AddLE.md

@@ -0,0 +1,29 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.AddLE
+title: AddLE operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: AddLE
+qsharp.summary: Sets a zero-initialized little-endian register zs to the sum of
+little-endian registers xs and ys
+---
+
+# AddLE operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation AddLE(xs : Qubit[], ys : Qubit[], zs : Qubit[]) : Unit is Adj
+```
+
+## Summary
+Sets a zero-initialized little-endian register zs to the sum of
+little-endian registers xs and ys
+
+## Description
+Computes zs := xs + ys modulo 2ⁿ, where xs, ys, and zs are little-endian registers,
+Length(xs) = Length(ys) ≤ Length(zs) = n, assuming zs is 0-initialized.
+NOTE: Use operations like RippleCarryCGAddLE directly if
+the choice of implementation is important.

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfEqualL.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfEqualL
+title: ApplyIfEqualL operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfEqualL
+qsharp.summary: Computes `if (c == x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is equal to the little-endian qubit register `x`
+---
+
+# ApplyIfEqualL operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfEqualL<'T>(action : ('T => Unit is Adj + Ctl), c : BigInt, xs : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if (c == x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is equal to the little-endian qubit register `x`

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfEqualLE.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfEqualLE
+title: ApplyIfEqualLE operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfEqualLE
+qsharp.summary: Computes `if x == y { action(target) }`, that is, applies `action` to `target`
+if register `x` is equal to the register `y`.
+Both qubit registers should be in a little-endian format.
+---
+
+# ApplyIfEqualLE operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfEqualLE<'T>(action : ('T => Unit is Adj + Ctl), x : Qubit[], y : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if x == y { action(target) }`, that is, applies `action` to `target`
+if register `x` is equal to the register `y`.
+Both qubit registers should be in a little-endian format.

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfGreaterL.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfGreaterL
+title: ApplyIfGreaterL operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfGreaterL
+qsharp.summary: Computes `if (c > x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is greater than the little-endian qubit register `x`
+---
+
+# ApplyIfGreaterL operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfGreaterL<'T>(action : ('T => Unit is Adj + Ctl), c : BigInt, x : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if (c > x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is greater than the little-endian qubit register `x`

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfGreaterLE.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfGreaterLE
+title: ApplyIfGreaterLE operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfGreaterLE
+qsharp.summary: Computes `if x > y { action(target) }`, that is, applies `action` to `target`
+if register `x` is greater than the register `y`.
+Both qubit registers should be in a little-endian format.
+---
+
+# ApplyIfGreaterLE operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfGreaterLE<'T>(action : ('T => Unit is Adj + Ctl), x : Qubit[], y : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if x > y { action(target) }`, that is, applies `action` to `target`
+if register `x` is greater than the register `y`.
+Both qubit registers should be in a little-endian format.

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfGreaterOrEqualL.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfGreaterOrEqualL
+title: ApplyIfGreaterOrEqualL operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfGreaterOrEqualL
+qsharp.summary: Computes `if (c >= x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is greater or equal to the little-endian qubit register `x`
+---
+
+# ApplyIfGreaterOrEqualL operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfGreaterOrEqualL<'T>(action : ('T => Unit is Adj + Ctl), c : BigInt, x : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if (c >= x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is greater or equal to the little-endian qubit register `x`

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfGreaterOrEqualLE.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfGreaterOrEqualLE
+title: ApplyIfGreaterOrEqualLE operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfGreaterOrEqualLE
+qsharp.summary: Computes `if x >= y { action(target) }`, that is, applies `action` to `target`
+if register `x` is greater or equal to the register `y`.
+Both qubit registers should be in a little-endian format.
+---
+
+# ApplyIfGreaterOrEqualLE operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfGreaterOrEqualLE<'T>(action : ('T => Unit is Adj + Ctl), x : Qubit[], y : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if x >= y { action(target) }`, that is, applies `action` to `target`
+if register `x` is greater or equal to the register `y`.
+Both qubit registers should be in a little-endian format.

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfLessL.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfLessL
+title: ApplyIfLessL operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfLessL
+qsharp.summary: Computes `if (c < x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is less than the little-endian qubit register `x`
+---
+
+# ApplyIfLessL operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfLessL<'T>(action : ('T => Unit is Adj + Ctl), c : BigInt, x : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if (c < x) { action(target) }`, that is, applies `action` to `target`
+if a BigInt value `c` is less than the little-endian qubit register `x`

package/docs/Microsoft.Quantum.Unstable.Arithmetic/ApplyIfLessLE.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Unstable.Arithmetic.ApplyIfLessLE
+title: ApplyIfLessLE operation
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: opeartion
+qsharp.namespace: Microsoft.Quantum.Unstable.Arithmetic
+qsharp.name: ApplyIfLessLE
+qsharp.summary: Computes `if x < y { action(target) }`, that is, applies `action` to `target`
+if register `x` is less than the register `y`.
+Both qubit registers should be in a little-endian format.
+---
+
+# ApplyIfLessLE operation
+
+Namespace: [Microsoft.Quantum.Unstable.Arithmetic](xref:Microsoft.Quantum.Unstable.Arithmetic)
+
+```qsharp
+operation ApplyIfLessLE<'T>(action : ('T => Unit is Adj + Ctl), x : Qubit[], y : Qubit[], target : 'T) : Unit is Adj + Ctl
+```
+
+## Summary
+Computes `if x < y { action(target) }`, that is, applies `action` to `target`
+if register `x` is less than the register `y`.
+Both qubit registers should be in a little-endian format.