Skip to content

Update API dev docs #4138

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 27, 2025
Merged

Update API dev docs #4138

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/api/qiskit-c/dev/_toc.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,10 +65,6 @@
"title": "QkTranspiler",
"url": "/docs/api/qiskit-c/dev/qk-transpiler"
},
{
"title": "QkVF2LayoutResult",
"url": "/docs/api/qiskit-c/dev/qk-vf-2-layout-result"
},
{
"title": "Transpiler Passes",
"url": "/docs/api/qiskit-c/dev/qk-transpiler-passes"
Expand All @@ -77,6 +73,10 @@
"title": "Versioning",
"url": "/docs/api/qiskit-c/dev/version"
},
{
"title": "VF2 compiler-pass objects",
"url": "/docs/api/qiskit-c/dev/qk-vf-2-layout"
},
{
"title": "Release notes",
"url": "/docs/api/qiskit/release-notes"
Expand Down
2 changes: 1 addition & 1 deletion docs/api/qiskit-c/dev/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Using the transpiler from the C API is intended to only cover circuits created s
* [QkTargetEntry](qk-target-entry)
* [QkTranspileLayout](qk-transpile-layout)
* [Transpiler Passes](qk-transpiler-passes)
* [QkVF2LayoutResult](qk-vf-2-layout-result)
* [VF2 compiler-pass objects](qk-vf-2-layout)
* [QkSabreLayoutOptions](qk-sabre-layout-options)

## Utilities
Expand Down
30 changes: 15 additions & 15 deletions docs/api/qiskit-c/dev/qk-target-entry.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_new" signature="QkTargetEntry *qk_target_entry_new(QkGate operation)">
Creates an entry to the `QkTarget` based on a `QkGate` instance.

<span id="group__QkTargetEntry_1autotoc_md217" />
<span id="group__QkTargetEntry_1autotoc_md222" />

#### Example

Expand All @@ -60,7 +60,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_new_measure" signature="QkTargetEntry *qk_target_entry_new_measure(void)">
Creates a new entry for adding a measurement instruction to a `QkTarget`.

<span id="group__QkTargetEntry_1autotoc_md218" />
<span id="group__QkTargetEntry_1autotoc_md223" />

#### Example

Expand Down Expand Up @@ -88,7 +88,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_new_reset" signature="QkTargetEntry *qk_target_entry_new_reset(void)">
Creates a new entry for adding a reset instruction to a `QkTarget`.

<span id="group__QkTargetEntry_1autotoc_md219" />
<span id="group__QkTargetEntry_1autotoc_md224" />

#### Example

Expand Down Expand Up @@ -116,7 +116,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_new_fixed" signature="QkTargetEntry *qk_target_entry_new_fixed(QkGate operation, double *params)">
Creates an entry in the `QkTarget` based on a `QkGate` instance with no parameters.

<span id="group__QkTargetEntry_1autotoc_md220" />
<span id="group__QkTargetEntry_1autotoc_md225" />

#### Example

Expand All @@ -125,11 +125,11 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
QkTargetEntry *entry = qk_target_entry_new_fixed(QkGate_CRX, crx_params);
```

<span id="group__QkTargetEntry_1autotoc_md221" />
<span id="group__QkTargetEntry_1autotoc_md226" />

#### Safety

<span id="group__QkTargetEntry_1autotoc_md221" />
<span id="group__QkTargetEntry_1autotoc_md226" />

The `params` type is expected to be a pointer to an array of `double` where the length matches the expectations of the `QkGate`. If the array is insufficiently long the behavior of this function is undefined as this will read outside the bounds of the array. It can be a null pointer if there are no params for a given gate. You can check `qk_gate_num_params` to determine how many qubits are required for a given gate.

Expand All @@ -152,7 +152,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_num_properties" signature="size_t qk_target_entry_num_properties(const QkTargetEntry *entry)">
Retrieves the number of properties stored in the target entry.

<span id="group__QkTargetEntry_1autotoc_md222" />
<span id="group__QkTargetEntry_1autotoc_md227" />

#### Example

Expand All @@ -162,11 +162,11 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
size_t props_size = qk_target_entry_num_properties(entry);
```

<span id="group__QkTargetEntry_1autotoc_md223" />
<span id="group__QkTargetEntry_1autotoc_md228" />

#### Safety

<span id="group__QkTargetEntry_1autotoc_md223" />
<span id="group__QkTargetEntry_1autotoc_md228" />

The behavior is undefined if `entry` is not a valid, non-null pointer to a `QkTargetEntry` object.

Expand All @@ -184,7 +184,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_free" signature="void qk_target_entry_free(QkTargetEntry *entry)">
Frees the entry.

<span id="group__QkTargetEntry_1autotoc_md224" />
<span id="group__QkTargetEntry_1autotoc_md229" />

#### Example

Expand All @@ -193,11 +193,11 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
qk_target_entry_free(entry);
```

<span id="group__QkTargetEntry_1autotoc_md225" />
<span id="group__QkTargetEntry_1autotoc_md230" />

#### Safety

<span id="group__QkTargetEntry_1autotoc_md225" />
<span id="group__QkTargetEntry_1autotoc_md230" />

The behavior is undefined if `entry` is not a valid, non-null pointer to a `QkTargetEntry` object.

Expand All @@ -215,7 +215,7 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
<Function id="qk_target_entry_add_property" signature="QkExitCode qk_target_entry_add_property(QkTargetEntry *entry, uint32_t *qargs, uint32_t num_qubits, double duration, double error)">
Adds an instruction property instance based on its assigned qargs.

<span id="group__QkTargetEntry_1autotoc_md226" />
<span id="group__QkTargetEntry_1autotoc_md231" />

#### Example

Expand All @@ -225,11 +225,11 @@ qk_target_entry_add_property(entry, NULL, 0, NAN, 0.003);
qk_target_entry_add_property(entry, qargs, 2, 0.0, 0.1);
```

<span id="group__QkTargetEntry_1autotoc_md227" />
<span id="group__QkTargetEntry_1autotoc_md232" />

#### Safety

<span id="group__QkTargetEntry_1autotoc_md227" />
<span id="group__QkTargetEntry_1autotoc_md232" />

The behavior is undefined if `entry` is not a valid, non-null pointer to a `QkTargetEntry` object.

Expand Down
Loading