# 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.
* 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-60e6df6724e4278e275f29c0087ee4d961d00888%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-99150bf3f240f8bee97bf105bc298713418fb1ec%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-9c6f91aa034a856aa4d589c407f5ad2a6813f075%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-dcd29025e29f7fcd7cfeebfb0e3731e703ef33bf%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-d41f1b914c1de377e411713fad7b19d5077ebd41%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>