# replace The `replace` function replaces occurrences of one or more substrings within a string. It supports replacing multiple different substrings in a single call and can be used either as a chained function or with explicit input. #### Syntax Chained form: ``` .replace(old, new[, old2, new2...]) ``` Function form: ``` replace(input, old, new[, old2, new2...]) ``` #### Arguments * **input** (`string`, optional when chained)\ The string to perform replacements on. * **old** (`string`)\ The substring to search for. * **new** (`string`)\ The replacement string. * **oldN / newN** (`string`, optional pairs)\ Additional replacement pairs. Each `old` must be followed by its corresponding `new`. #### Examples **Chained usage** ``` dasel '"hello world".replace("world", "there")' ``` **Output** ``` hello there ``` **Function usage** ``` dasel 'replace("hello world", "world", "there")' ``` **Output** ``` hello there ``` **Multiple replacements** ``` dasel '"a-b-c".replace("-", "_", "a", "x")' ``` **Output** ``` x_b_c ``` **Replace multiple patterns at once** ``` dasel 'replace("one two three", "one", "1", "two", "2", "three", "3")' ``` **Output** ``` 1 2 3 ``` #### Notes * Replacements are applied in a single pass. * Each replacement must be provided as a pair (`old`, `new`). * If an odd number of arguments is supplied, the first argument is treated as the input string. * All arguments must be strings. * Replacement is literal (not regex-based).