Accumulation Set Item¶
Updates an element at a specific index within an Accumulation. It performs an in-place modification of the internal list and returns the same Accumulation object reference. If the index is invalid or the structure is not an Accumulation, it safely returns the original Accumulation unchanged.
Usage¶
Use this node when you need to overwrite a particular element inside an existing Accumulation, such as correcting a value or replacing a placeholder. Typically placed after building an Accumulation (e.g., via Accumulate or List to Accumulation) and before nodes that consume the updated list.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| accumulation | True | ACCUMULATION | The Accumulation to modify. Must be a valid Accumulation produced by compatible nodes. | |
| index | True | INT | Zero-based position of the element to set. Negative indices are supported (Python-style) and count from the end. | 2 |
| value | True | WILDCARD | The new value to place at the specified index. Should match the expected item type used within the Accumulation. | example item |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| accumulation | ACCUMULATION | The same Accumulation object after the attempted update. If an error occurs (e.g., index out of range), the original Accumulation is returned unchanged. |
Important Notes¶
- This node mutates the Accumulation in place; downstream branches sharing the same Accumulation reference will see the change.
- Negative indices are allowed (e.g., -1 refers to the last element).
- If the index is out of range or the input is not a valid Accumulation, the node logs an error internally and returns the original Accumulation without changes.
- For best results, ensure the value type is consistent with other elements in the Accumulation, especially if downstream nodes expect a specific type.
Troubleshooting¶
- Item did not change: Verify the index is within the valid range of the Accumulation length.
- Type-related issues downstream: Ensure the 'value' you set matches the expected type used by subsequent nodes.
- Unexpected no-op: Confirm the input is a valid Accumulation produced by the proper nodes, not a plain list or other structure.
- Changes appearing in multiple places: Remember this node updates the Accumulation in place; if the same Accumulation is reused in multiple branches, all will reflect the update.