# SUBSTITUTE

#### Syntax <a href="#syntax.53" id="syntax.53"></a>

**SUBSTITUTE**(*text*; *oldText*; *newText; option*)

* *text* - der Text, in dem nach oldText gesucht werden soll - ***Wertetyp**: Text*
* *oldText* - den Text, der im Parameter text zu finden ist - ***Wertetyp**: Text*
* *newText* - der Text, durch den oldText ersetzt werden soll- ***Wertetyp**: Text*
* *option* - definiert, ob die Ersetzung mit einem regulären Ausdruck erfolgen soll - ***Wertetyp**: Konstante (optional, Standardwert: empty)*

  Mögliche Werte sind:

  * *empty* (*option* ist nicht angegeben) - die Ersetzung basiert auf dem Klartext von *oldText* und *newText*
  * *<mark style="color:red;">regex</mark>* - die Ersetzung verwendet einen regulären Ausdrucks für den Parameter *oldText*

#### Bemerkungen <a href="#remarks.40" id="remarks.40"></a>

* Der Parameter *text* kann auch ein Bereich sein mit mehreren Texten. Die SUBSTITUTE Funktion in dann auf alle diese Texte angewendet.&#x20;
* Für die Parameter *oldText* und *newText* können auch Spaltenbereiche angegeben werden. Die Textersetzung erfolgt dann nacheinander (von oben nach unten) für alle Textpaare dieser beiden Parameter.
* Bei der Suche wird die Groß- und Kleinschreibung beachtet, so dass der gefundene Text im Parameter *text* die gleiche Groß- und Kleinschreibung haben muss wie der Parameter *oldText*.

#### Beispiele <a href="#examples.17" id="examples.17"></a>

<figure><img src="/files/v2MMsxZ41mwMbRyA5zhd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fN8UWHe6J9DY1MxmMo7O" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/41a16HmFT4s3W2KfjoTV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PXIQ91it4jEHX2JkCFTa" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fagFe6Yu5DsT3dtRhpie" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nedyx.com/version-1.52-de-preview/clearlines-funktionen/text-funktionen/substitute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.