| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame^] | 1 | SYNOPSIS |
| 2 | string regreplace(string txt, string pattern, |
| 3 | string|closure replacepattern, int flags) |
| 4 | |
| 5 | BESCHREIBUNG |
| 6 | Die Funktion durchsucht den String txt nach einem Vorkommen |
| 7 | des regulaeren Ausdrucks pattern, und ersetzt ihn durch |
| 8 | den String replacepattern. (replacepattern kann auch eine Closure |
| 9 | sein. Sie bekommt als argument den passenden Substring und muss |
| 10 | den Ersatzstring zurueckliefern.) |
| 11 | |
| 12 | Im replacestring kann man via '&' auf den zum Suchausdruck |
| 13 | passenden Teilstring im Original zugreifen. Mit \n (wobei n |
| 14 | eine Ganzzahl ist) kann man auf den n-ten Unterausdruck |
| 15 | des regulaeren Ausdrucks zugreifen. Um "&" oder "\\1" als |
| 16 | Ersetzung zu erreichen, muss "\\&" bzw "\\\\1" verwendet werden. |
| 17 | |
| 18 | Beim Flag bestimmt ein gesetztes Bit 0, dass der Ausdruck so oft |
| 19 | wie vorhanden ersetzt wird, sonst nur das erste Auftreten. |
| 20 | Bit 1 bestimmt, ob der regulaere Ausdruck 'ed' oder 'sed' kompatibel |
| 21 | ist (Bit geloescht) oder 'ex' kompatibel (gesetzt). |
| 22 | |
| 23 | Die Funktion wirkt wie s/pattern/replacepattern/flags in |
| 24 | Editoren wie vi oder sed. Sie ist besonders gut geeignet um |
| 25 | variable Strings zu ersetzen, im Gegensatz zu regexplode, wo |
| 26 | man den String nur nach einem regulaeren Ausdruck zerlegen kann. |
| 27 | |
| 28 | BEISPIELE |
| 29 | // ersetzt @@wer@@ durch den Namen des Objektes |
| 30 | regreplace(str,"@@wer@@",(string)obj->name(WER,2),1) |
| 31 | |
| 32 | // ersetze alle doppelten Leerzeichen durch ein einzelnes |
| 33 | regreplace(str, " *", " ", 1); |
| 34 | |
| 35 | // Sucht nach 'teilt Dir mit: ' und schliesst den nachfolgenden |
| 36 | // Text mit <underline> und </underline> ein; bei jedem Auftreten. |
| 37 | |
| 38 | msgin = regreplace(msgin, "teilt Dir mit: (.*)", |
| 39 | "teilt Dir mit: <underline>\\1</underline>", |
| 40 | 1); |
| 41 | |
| 42 | // Ersetzt die <underline> html-Tags durch die vt100 |
| 43 | // Escape-Sequenzen fuer Unterstreichung |
| 44 | txt = regreplace(txt, "<underline>", "<ESC>[5m", 1); |
| 45 | |
| 46 | // Ersetzt das Wort HOUSE in Kleinbuchstaben. |
| 47 | txt = regreplace(txt, "HOUSE", #'lower_case, 1); |
| 48 | |
| 49 | BUGS: |
| 50 | I have written that efun. It doesn't have BUGS. By definition. |
| 51 | Well, in fact it crashed as I first tried it on running TAPPMud. |
| 52 | *sigh* |
| 53 | Marcus@TAPPMud |
| 54 | |
| 55 | SIEHE AUCH |
| 56 | Verwandt: regexp(E), regexplode(E), sscanf(E) |
| 57 | Aehnlich: replace_personal(L) |