# 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="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/dJn3sqMCgbtSJsPDxNUv/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/wePFQ2YSBv1k4FgheubB/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/r0SebnzTBsAqEvszh6E1/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/bhtsArjXDSsOZIsE1fPg/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/4oURltL61nsMadyK0Wen/image.png" alt=""><figcaption></figcaption></figure>