Edit DAT content (surgical)
edit_dat_contentDestructive
Replace a substring within a Text or Table DAT's text in TouchDesigner. Requires exactly one match unless replace_all is set, enabling precise, targeted edits.
Instructions
Surgically replace a substring inside a Text or Table DAT's .text. Without replace_all, requires exactly one match — 0 or >1 occurrences is an error, forcing the caller to add context or set replace_all. Use set_dat_content to overwrite an entire DAT's text in place; use this to make a targeted edit. Because DAT text can become executable callbacks, this tool is hidden when TDMCP_RAW_PYTHON=off and the bridge also requires TDMCP_BRIDGE_ALLOW_EXEC=1 for writes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dat_path | Yes | Absolute path to the Text or Table DAT to edit (e.g. '/project1/mytext1'). | |
| new_string | Yes | Replacement text. May be empty to delete the matched substring. | |
| old_string | Yes | Exact substring to find. Must match at least once. Empty strings are rejected. | |
| replace_all | No | When false (default), requires exactly one match — 0 or >1 occurrences is an error. Set true to replace every occurrence. |