qsharp-lang 1.3.6-dev → 1.4.0

package/docs/Microsoft.Quantum.Arrays/MappedOverRange.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.MappedOverRange
 title: MappedOverRange function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Most.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Most
 title: Most function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/MostAndTail.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.MostAndTail
 title: MostAndTail function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Padded.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Padded
 title: Padded function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Partitioned.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Partitioned
 title: Partitioned function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Rest.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Rest
 title: Rest function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Reversed.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Reversed
 title: Reversed function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/SequenceI.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.SequenceI
 title: SequenceI function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/SequenceL.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.SequenceL
 title: SequenceL function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Sorted.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Sorted
 title: Sorted function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Subarray.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Subarray
 title: Subarray function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Swapped.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Swapped
 title: Swapped function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Tail.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Tail
 title: Tail function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Transposed.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Transposed
 title: Transposed function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Unzipped.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Unzipped
 title: Unzipped function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Where.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Where
 title: Where function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Windows.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Windows
 title: Windows function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Arrays/Zipped.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Arrays.Zipped
 title: Zipped function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Arrays

package/docs/Microsoft.Quantum.Canon/ApplyCNOTChain.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyCNOTChain
 title: ApplyCNOTChain operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyControlledOnBitString.md

@@ -1,12 +1,12 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyControlledOnBitString
 title: ApplyControlledOnBitString operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon
 qsharp.name: ApplyControlledOnBitString
-qsharp.summary: "Applies a unitary operation on the target, controlled on a state specified by a given bit mask."
+qsharp.summary: "Applies `oracle` on `target` when `controlRegister` is in the state specified by `bits`."
 ---
 
 # ApplyControlledOnBitString operation
@@ -18,8 +18,17 @@ operation ApplyControlledOnBitString<'T>(bits : Bool[], oracle : ('T => Unit is
 ```
 
 ## Summary
-Applies a unitary operation on the target,
-controlled on a state specified by a given bit mask.
+Applies `oracle` on `target` when `controlRegister`
+is in the state specified by `bits`.
+
+## Description
+Applies a unitary operation `oracle` on the `target`, controlled
+on a state specified by a given bit mask `bits`.
+The bit at `bits[i]` corresponds to qubit at `controlRegister[i]`.
+The pattern given by `bits` may be shorter than `controlRegister`,
+in which case additional control qubits are ignored (that is, neither
+controlled on |0⟩ nor |1⟩).
+If `bits` is longer than `controlRegister`, an error is raised.
 
 ## Input
 ### bits
@@ -31,11 +40,13 @@ The target to be passed to `oracle` as an input.
 ### controlRegister
 A quantum register that controls application of `oracle`.
 
-## Remarks
-The pattern given by `bits` may be shorter than `controlRegister`,
-in which case additional control qubits are ignored (that is, neither
-controlled on $\ket{0}$ nor $\ket{1}$).
-If `bits` is longer than `controlRegister`, an error is raised.
-
-For example, `bits = [0,1,0,0,1]` means that `oracle` is applied if and only if `controlRegister`
-is in the state $\ket{0}\ket{1}\ket{0}\ket{0}\ket{1}$.
+## Example
+```qsharp
+// When bits = [1,0,0] oracle is applied if and only if controlRegister
+// is in the state |100⟩.
+use t = Qubit();
+use c = Qubit[3];
+X(c[0]);
+ApplyControlledOnBitString([true, false, false], X, c, t);
+Message($"{M(t)}"); // Prints `One` since oracle `X` was applied.
+```

package/docs/Microsoft.Quantum.Canon/ApplyControlledOnInt.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyControlledOnInt
 title: ApplyControlledOnInt operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyP.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyP
 title: ApplyP operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyPauli.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyPauli
 title: ApplyPauli operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyPauliFromBitString.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyPauliFromBitString
 title: ApplyPauliFromBitString operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyPauliFromInt.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyPauliFromInt
 title: ApplyPauliFromInt operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyQFT.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyQFT
 title: ApplyQFT operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyToEach.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyToEach
 title: ApplyToEach operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyToEachA.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyToEachA
 title: ApplyToEachA operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyToEachC.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyToEachC
 title: ApplyToEachC operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyToEachCA.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyToEachCA
 title: ApplyToEachCA operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyXorInPlace.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyXorInPlace
 title: ApplyXorInPlace operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/ApplyXorInPlaceL.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.ApplyXorInPlaceL
 title: ApplyXorInPlaceL operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/CX.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.CX
 title: CX operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/CY.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.CY
 title: CY operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon
@@ -30,10 +30,12 @@ Target qubit for the CY gate.
 This operation can be simulated by the unitary matrix
 $$
 \begin{align}
-    1 & 0 & 0 & 0 \\\\
-    0 & 1 & 0 & 0 \\\\
-    0 & 0 & 0 & -i \\\\
-    0 & 0 & i & 0
+    \left(\begin{matrix}
+        1 & 0 & 0 & 0 \\\\
+        0 & 1 & 0 & 0 \\\\
+        0 & 0 & 0 & -i \\\\
+        0 & 0 & i & 0
+     \end{matrix}\right)
 \end{align},
 $$
 where rows and columns are organized as in the quantum concepts guide.

package/docs/Microsoft.Quantum.Canon/CZ.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.CZ
 title: CZ operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon
@@ -30,10 +30,12 @@ Target qubit for the CZ gate.
 This operation can be simulated by the unitary matrix
 $$
 \begin{align}
-    1 & 0 & 0 & 0 \\\\
-    0 & 1 & 0 & 0 \\\\
-    0 & 0 & 1 & 0 \\\\
-    0 & 0 & 0 & -1
+    \left(\begin{matrix}
+        1 & 0 & 0 & 0 \\\\
+        0 & 1 & 0 & 0 \\\\
+        0 & 0 & 1 & 0 \\\\
+        0 & 0 & 0 & -1
+    \end{matrix}\right)
 \end{align},
 $$
 where rows and columns are organized as in the quantum concepts guide.

package/docs/Microsoft.Quantum.Canon/Fst.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.Fst
 title: Fst function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/Snd.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.Snd
 title: Snd function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Canon/SwapReverseRegister.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Canon.SwapReverseRegister
 title: SwapReverseRegister operation
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.namespace: Microsoft.Quantum.Canon

package/docs/Microsoft.Quantum.Convert/BigIntAsBoolArray.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.BigIntAsBoolArray
 title: BigIntAsBoolArray function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/BoolArrayAsBigInt.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.BoolArrayAsBigInt
 title: BoolArrayAsBigInt function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/BoolArrayAsInt.md

@@ -1,12 +1,12 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.BoolArrayAsInt
 title: BoolArrayAsInt function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert
 qsharp.name: BoolArrayAsInt
-qsharp.summary: "Produces a non-negative integer from a string of bits in little endian format."
+qsharp.summary: "Produces a non-negative integer from a string of bits in little-endian format. `bits[0]` represents the least significant bit."
 ---
 
 # BoolArrayAsInt function
@@ -18,7 +18,8 @@ function BoolArrayAsInt(bits : Bool[]) : Int
 ```
 
 ## Summary
-Produces a non-negative integer from a string of bits in little endian format.
+Produces a non-negative integer from a string of bits in little-endian format.
+`bits[0]` represents the least significant bit.
 
 ## Input
 ### bits

package/docs/Microsoft.Quantum.Convert/BoolArrayAsResultArray.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.BoolArrayAsResultArray
 title: BoolArrayAsResultArray function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/BoolAsResult.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.BoolAsResult
 title: BoolAsResult function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/ComplexAsComplexPolar.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.ComplexAsComplexPolar
 title: ComplexAsComplexPolar function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/ComplexPolarAsComplex.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.ComplexPolarAsComplex
 title: ComplexPolarAsComplex function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/IntAsBigInt.md

@@ -1,12 +1,12 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.IntAsBigInt
 title: IntAsBigInt function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert
 qsharp.name: IntAsBigInt
-qsharp.summary: "Converts a given integer to an equivalent big integer."
+qsharp.summary: "Converts a given integer `number` to an equivalent big integer."
 ---
 
 # IntAsBigInt function
@@ -18,4 +18,4 @@ function IntAsBigInt(number : Int) : BigInt
 ```
 
 ## Summary
-Converts a given integer to an equivalent big integer.
+Converts a given integer `number` to an equivalent big integer.

package/docs/Microsoft.Quantum.Convert/IntAsBoolArray.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.IntAsBoolArray
 title: IntAsBoolArray function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/IntAsDouble.md

@@ -1,12 +1,12 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.IntAsDouble
 title: IntAsDouble function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert
 qsharp.name: IntAsDouble
-qsharp.summary: "Converts a given integer to an equivalent double-precision floating-point number."
+qsharp.summary: "Converts a given integer `number` to an equivalent double-precision floating-point number."
 ---
 
 # IntAsDouble function
@@ -18,4 +18,18 @@ function IntAsDouble(number : Int) : Double
 ```
 
 ## Summary
-Converts a given integer to an equivalent double-precision floating-point number.
+Converts a given integer `number` to an equivalent
+double-precision floating-point number.
+
+## Description
+Converts a given integer to a double-precision floating point number.
+Please note that the double-precision representation may have fewer
+bits allocated to represent [significant digits](https://en.wikipedia.org/wiki/Significand)
+so the conversion may be approximate for large numbers. For example,
+the current simulator converts 4,611,686,018,427,387,919 = 2^64+15
+to 4,611,686,018,427,387,904.0 = 2^64.
+
+## Example
+```qsharp
+Message($"{IntAsDouble(1)}"); // Prints 1.0 rather than 1
+```

package/docs/Microsoft.Quantum.Convert/ResultArrayAsBoolArray.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.ResultArrayAsBoolArray
 title: ResultArrayAsBoolArray function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert

package/docs/Microsoft.Quantum.Convert/ResultArrayAsInt.md

@@ -1,7 +1,7 @@
 ---
 uid: Qdk.Microsoft.Quantum.Convert.ResultArrayAsInt
 title: ResultArrayAsInt function
-ms.date: 04/17/2024 12:00:00 AM
+ms.date: 04/23/2024 12:00:00 AM
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.namespace: Microsoft.Quantum.Convert