prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » substRE()

substRE()

Eine Zeichenkette mittels eines regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.

Syntax:

any substRE ( text, search, replace )
any substRE ( text, search, replace, max_count )
any substRE ( text, search, replace, max_count, bool:ignore_case )

Parameter:

text Text, indem gesucht wird und indem Textsellen ersetzt werden. Der Parameter wird mittels string() zwangsweise in eine Zeichenkette gewandelt.
search Eine Liste mit Texten. Nicht-Listen Werte werden zwangsweise mittels list() in eine Liste überführt. Diese Texte werden als Suchmuster verwendet.
replace Eine Liste mit Texten. Nicht-Listen Werte werden zwangsweise mittels list() in eine Liste überführt. Mit diesen Texten werden die Fundstellen ersetzt.
max_count Eine Ganzzahl, die die maximale Anzahl der Ersetzungen angibt. Negative Werte bedeuten, dass alle Fundstellen ersezt werden sollen.
ignore_case Das Suchen erfolgt unabhängig von der Groß- und Kleinschreibung.

Beschreibung:

Die beiden Parameter search oder replace werden zwangsweise in Listen gewandelt. Aus Skalaren Typen wird eine Liste mit exakt einem Element erzeugt. Alle Elemente beider Listen werden mittels string() in Zeichenketten gewandelt.

Nach dieser Umwandlung wird die Such-Liste search iterativ beginnend von Index Null abgearbeitet. Die ersten max_count Fundstellen (alle, falls max_count<0) werden durch das korrespondierende Element (identischer Index) aus der replace-Liste ersetzt. Sollte die replace-Liste nicht genügend Elemente besitzen, dann wird das letze Element der Liste mehrfach als Ersetzung verwendet.

Funktionsergebnis:   STRING

Als Funktionsergebnis wird die Zeichenkette nach allen Ersetzungen geliefert.

Siehe auch:
 substPCRE()   subst()   substChar()   findRE() 

Weitere ähnliche Funktionen:

Reguläre Ausdrücke
Funktion Kurzinfo
compileRE() Eine RegEx übersetzen und einer eindeutigen ID zuweisen.
countRE() Die Anzahl der Treffer eines RegEx berechnen.
findAllRE() Alle Vorkommen einer Zeichenkette mittels eines RegEx suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findRE() Eine Zeichenkette mittels eines RegEx suchen und die Startposition dieser Zeichenkette ermitteln.
findTextRE() Eine Zeichenkette mittels eines RegEx suchen und den gefundenen Text als Ergebnis liefern.
itemRE()
m$findKeysRE()
splitRE()
substRE() Eine Zeichenkette mittels eines regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
 
Suchen & Ersetzen
Funktion Kurzinfo
compilePCRE() Eine PCRE übersetzen und einer eindeutigen ID zuweisen.
compileRE() Eine RegEx übersetzen und einer eindeutigen ID zuweisen.
count()
countNum() Die Anzahl der numerischen Elemente zählen.
countPCRE() Die Anzahl der Treffer eines PCRE berechnen.
countRE() Die Anzahl der Treffer eines RegEx berechnen.
countVal() Die Anzahl der skalaren Elemente zählen.
find()
findAllPCRE() Alle Vorkommen einer Zeichenkette mittels eines PCRE suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findAllRE() Alle Vorkommen einer Zeichenkette mittels eines RegEx suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findPCRE() Eine Zeichenkette mittels eines PCRE suchen und die Startposition dieser Zeichenkette ermitteln.
findRE() Eine Zeichenkette mittels eines RegEx suchen und die Startposition dieser Zeichenkette ermitteln.
findReverse()
findTextPCRE() Eine Zeichenkette mittels eines PCRE suchen und den gefundenen Text als Ergebnis liefern.
findTextRE() Eine Zeichenkette mittels eines RegEx suchen und den gefundenen Text als Ergebnis liefern.
item()
itemPCRE()
itemRE()
m$find2() Ein Element in einer Map oder ersatzweise die virtuellen Nachbarn suchen.
m$find3() Ein Element in einer Map und seine virtuellen Nachbarn suchen.
m$findKeys()
m$findKeysBegin()
m$findKeysEnd()
m$findKeysPCRE()
m$findKeysRE()
m$findNext() Den Nachfolger in einer Map zu einem gegebenen Schlüssel finden.
m$findPrev() Den Vorgänger in einer Map zu einem gegebenen Schlüssel finden.
replace()
split()
splitEol() Aus einem Text eine Liste mit den einzelnen Zeilen erzeugen.
splitPCRE()
splitRE()
splitString()
subst() Eine Zeichenkette suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substChar() In einer Zeichenkette nach einzelnen Zeichen suchen und die Fundstellen durch Zeichenketten ersetzen.
substPCRE() Eine Zeichenkette mittels eines Perl kompatiblen regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substRE() Eine Zeichenkette mittels eines regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.