|
Makro
|
Beschreibung
|
%XMP_ArgCount(Text, [Trennzeichen],
[Anführungszeichen])
|
Ermittelt die Anzahl der Einträge in einem "Text", die mit einem der angegebenen "Trennzeichen" voneinander getrennt sind. Trennzeichen, die sich innerhalb eines der "Anführungszeichen" befinden, werden ignoriert.
Ist "Trennzeichen" nicht angegeben, wird ein Leerzeichen angenommen. Wird kein "Anführungszeichen" angegeben, wird ein normales Anführungszeichen (") verwendet.
Beispiel:
%XMP_ArgCount(|"ABC 123 XYZ"789 test1 test2|)
%XMP_ArgCount(|"ABC,123,XYZ" 789,test1,test2|,|,|)
%XMP_ArgCount(|'ABC#123#XYZ" 789#test1:test2|,|#:|,|'"|)
Ausgabe:
3
3
3
|
%XMP_ArgItem(Text, Eintrag [Trennzeichen],
[Anführungszeichen])
|
Gibt einen bestimmten "Eintrag" aus einem "Text" zurück, der mit einem der angegebenen "Trennzeichen" von anderen Einträgen getrennt ist. Trennzeichen, die sich innerhalb eines der "Anführungszeichen" befinden, werden ignoriert.
Ist "Trennzeichen" nicht angegeben, wird ein Leerzeichen angenommen. Wird kein "Anführungszeichen" angegeben, wird ein normales Anführungszeichen (") verwendet.
Beispiel:
%XMP_ArgItem(|"ABC 123 XYZ"789 test1 test2|,|2|)
%XMP_ArgItem(|"ABC,123,XYZ" 789,test1,test2|,|3|,|,|)
%XMP_ArgItem(|'ABC:123#XYZ" 789#test1:test2|,|1|,|#:|,|'"|)
Ausgabe:
test1
test2
'ABC:123#XYZ" 789
|
|
%XMP_Decode(Text, Methode)
|
Dekodiert einen "Text", der im MIME-Format (Base64) oder im Quoted-Printable-Format vorliegt.
Das Argument "Methode" gibt an, ob der Text im Base64-Format ist (Argument "B") oder im Quoted-Printable-Format (Argument "Q").
Beispiel:
%XMP_Decode("RGV1dHNjaGxhbmQgaXN0IHNjaPZu","B")
%XMP_Decode("est une soci=E9t=E9 Suisse","Q")
Ausgabe:
Deutschland ist schön
est une société Suisse
|
|
%XMP_Encode(Text, Methode)
|
Kodiert einen "Text" als MIME (Base64) oder als Quoted-Printable.
Das Argument "Methode" gibt an, ob der Text als Base64 (Argument "B") oder als Quoted-Printable (Argument "Q") kodiert werden soll.
Beispiel:
%XMP_Encode("Deutschland ist schön","B")
%XMP_Encode("est une société Suisse","Q")
Ausgabe:
RGV1dHNjaGxhbmQgaXN0IHNjaPZu
est une soci=E9t=E9 Suisse
|
|
%XMP_Grep(Text, RegExp, [Ausgabe])
|
Durchsucht einen "Text" zeilenweise mit dem reguläre Ausdruck "RegExp". "Ausgabe" gibt an, welche Zeilen ausgegeben werden sollen:
M -> Gibt alle Zeilen aus, auf die der reguläre Ausdruck zutrifft. (Standard, falls nicht angegeben)
N -> Gibt alle Zeilen aus, auf die der reguläre Ausdruck nicht zutrifft.
B -> Gibt alle Zeilen aus, die vor dem ersten gefundenen regulären Ausdruck stehen.
A - > Gibt alle Zeilen aus, die nach dem ersten gefundenen regulären Ausdruck stehen.
I -> Kann zusätzlich zu "A" oder "B" angegeben werden und bewirkt, dass die Zeile, auf die der reguläre Ausdruck zutrifft, ebenfalls mit ausgegeben wird.
Achtung: Da es zu Problemen kommen kann, wenn im "Text" Anführungszeichen enthalten sind, werden diese durch den Hexadezimalcode 0x02 ersetzt. Darum muss in den regulären Ausdrücken für ein Anführungszeichen der Hexadezimalcode 0x02, also "\x02" (an Stelle von "\x22") verwendet werden.
Beispiel:
Alle Zeilen mit "http://www.":
%XMP_Grep("%TEXT","http:\/\/www\.")
Beispiel-Ausgabe:
Alle Zeilen mit "http://www.":
> Unsere URL lautet https://www.ritlabs.com/
Auf https://www.ritlabs.com/ finden Sie auch das Extended Macro Plugin
https://www.ritlabs.com/
|
|
%XMP_HtmlDec(Text, [Optionen])
|
Dieses Makro dekodiert HTML-Entitäten in einem "Text" in die entsprechenden Sonderzeichen.
Das optionale Argument "Optionen" bestimmt die Art der Kodierung:
E -> Es werden HTML-Entitäten (außer kodierte HTML-Steuerzeichen) in nationale Sonderzeichen dekodiert. Diese Methode wird verwendet, wenn der Parameter "Optionen" nicht angegeben wurde.
H -> Es werden HTML-Steuerzeichen dekodiert (Größer-Zeichen, Kleiner-Zeichen, doppelte Anführungszeichen und das kaufmännische Und).
Beispiel:
%XMP_HtmlDec('<b>"àéî€ & äöüß
"</b>')
%XMP_HtmlDec('<b>"àéî€ & äöüß
"</b>','H')
%XMP_HtmlDec('<b>"àéî€ & äöüß
"</b>','EH')
Ausgabe:
<b>"àéî€ & äöüß"</b>
<b>"àéî€ & äöüß"</b>
<b>"àéî€ & äöüß"</b>
|
|
%XMP_HtmlEnc(Text, [Optionen])
|
Dieses Makro kodiert Sonderzeichen in einem "Text" in HTML-Entitäten.
Das optionale Argument "Optionen" bestimmt die Art der Kodierung:
E -> Es werden nationale Sonderzeichen, z.B. deutsche Umlaute, in benannte Entitäten kodiert. Diese Methode wird verwendet, wenn der Parameter "Optionen" nicht angegeben wurde.
U -> Es werden nationale Sonderzeichen, z.B. deutsche Umlaute, mit ihrenen Zeichen-Codes kodiert.
H -> Es werden HTML-Steuerzeichen kodiert (Größer-Zeichen, Kleiner-Zeichen, doppelte Anführungszeichen und das kaufmännische Und).
Beispiel:
%XMP_HtmlEnc('<b>"àéî€ & äöüß"</b>')
%XMP_HtmlEnc('<b>"àéî€ & äöüß"</b>','U')
%XMP_HtmlEnc('<b>"àéî€ & äöüß"</b>','H')
%XMP_HtmlEnc('<b>"àéî€ & äöüß"</b>','EH')
%XMP_HtmlEnc('<b>"àéî€ & äöüß"</b>','UH')
Ausgabe:
<b>"àéî€ & äöü
ß"</b>
<b>"àéî€ & äöüß
"</b>
<b>"àéî€ & äöüß"</b>
<b>"àéî€ & äö
üß"</b>
<b>"àéî€ & äö
üß"</b>
|
%XMP_LineBtw(Text, Start, Ende, [StartPos,
EndePos])
|
Gibt jenen Teil einer Zeile aus "Text" zurück, der zwischen "Start" und "Ende" angegeben wurde. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.
"StartPos" bzw. "EndePos" gibt jeweils für "Start" und "Ende" an, ob die Suchbegriffe am Beginn oder am Ende der Zeile stehen. Dabei steht 1 für den Beginn bzw. dem Ende der Zeile. Wird für "StartPos" oder "EndePos" der Wert "0" angegeben oder werden diese Angaben weggelassen, wird die gesamte Zeile nach "Start" und "Ende" durchsucht.
Beispiel-Text:
Name: Huber, Karl
Ort: 1234 Stadt
S/N: 173993783892.TEST
Beispiel:
%XMP_LineBtw("%TEXT","Name:",", ",0,1)
%XMP_LineBtw("%TEXT","Ort:","",0,0)
%XMP_LineBtw("%TEXT","S/N:",".test",0,0)
Beispiel-Ausgabe:
Huber
1234 Stadt
173993783892
|
%XMP_REIsMatch(Text, Suche, [StartPos],
[GroßKlein])
|
Sucht im "Text" nach "Suche" mit einem regulären Ausdruck (PCRE). Wird der Suchbegriff gefunden, wird "1" zurückgegeben, ansonsten "0".
Mit dem optionalen Parameter "StartPos" kann die Startposition für die Suche angegeben werden. "0" entspricht dem Anfang des Textes.
Ist unter "GroßKlein" der Wert "1" eingetragen, wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiel:
%XMP_REIsMatch("abc","b")
%XMP_REIsMatch("abc","b",2)
%XMP_REIsMatch("abc","B",0,1)
Ausgabe:
1
0
1
|
|
%XMP_RERepl(Text, Suche, Neu, [GroßKlein])
|
Sucht im "Text" nach "Suche" mit einem regulären Ausdruck (PCRE). Wird der Suchbegriff gefunden, wird "1" zurückgegeben, ansonsten "0".
Mit dem optionalen Parameter "StartPos" kann die Startposition für die Suche angegeben werden. "0" entspricht dem Anfang des Textes.
Ist unter "GroßKlein" der Wert "1" eingetragen, wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiel:
%XMP_RERepl("AbC AbC AbC","(b)","[$1]")
Ausgabe:
A[b]C A[b]C A[b]C
|
|
%XMP_ReX(Text, Ausdruck,[SubPatt])
|
Dieses Makro ist eine Vereinfachung der RegExp-Makros von The Bat!. Das Argument "Text" legt den Text fest, der durchsucht werden soll. "Ausdruck" steht für den regulären Ausdruck, nach den gesucht werden soll. Wird "SubPatt" angegeben, wird das entsprechende Sub-Pattern zurückgegeben, sonst wird das erste Sub-Pattern zurückgegeben.
Wird "SubPatt" angegeben, entspricht die Arbeitsweise der von "%REGEXPBLINDMATCH". Wird "SubPatt" nicht angegeben, wie der von "%REGEXPMATCH".
Achtung: Da es zu Problemen kommen kann, wenn im "Text" Anführungszeichen enthalten sind, werden diese durch den Hexadezimalcode 0x02 ersetzt. Darum muss in den regulären Ausdrücken für ein Anführungszeichen der Hexadezimalcode 2, also "\x02" verwendet werden.
Beispiel:
%XMP_ReX("abc test TEXT abc",".*(test)(\s)(.*)\s.*")
%XMP_ReX("abc test TEXT abc",".*(test)(\s)(.*)\s.*","0")
%XMP_ReX("abc test TEXT abc",".*(test)(\s)(.*)\s.*",3)
Ausgabe:
test
abc test TEXT abc
TEXT
|
|
%XMP_StrAttach(Text, Dateiname)
|
Speichert den "Text" in einer temporären Datei mit dem angegebenen "Dateienen" und fügt diese Datei anschließend als Anlage zur aktuellen Nachricht hinzu.
Tritt ein Fehler auf, wird "0" zurückgegeben, sonst ist die Rückgabe "1".
Die temporäre Datei wird danach NICHT gelöscht, da The Bat! diese sonst nicht findet und nicht als Anlage hinzufügen kann. Erst beim Entladen des Plugins (Beenden von The Bat!) werden alle durch dieses Makro erstellten Dateien gelöscht.
Beispiel:
%XMP_StrAttach("%TEXT","Originaltext.txt")
|
|
%XMP_StrC(Text)
|
Gibt den angegebenen "Text" aus und ersetzt dabei maskierte Sonderzeichen.
Folgende Sonderzeichen können verwendet werden:
\\ -> Backslash
\n ->Zeilenvorschub
\r ->Wagenrücklauf
\t ->Tabulator
\w ->Wagenrücklauf + Zeilenvorschub (entspricht "\r\n")
\cCHR ->CHR ist der Zeichencode von 000 bis 255 und MUSS dreistellig sein!
\xHH ->HH ist der Hexadezimalcode von 00 bis FF und MUSS zweistellig sein! (Die Groß- und Kleinschreibung wird nicht beachtet.)
Beispiel:
%XMP_StrC("\c034Zeile1\c034\nZeile2\tTabulator\n\nZeile4")
--
%XMP_StrC("\x55\x56\x57\x0A\c034XYZ\c034")
Ausgabe:
"Zeile1"
Zeile2 Tabulator
Zeile4
--
UVW
"XYZ"
|
%XMP_StrChar(Zeichencode,
[Zeichencode], ...)
|
Wandelt die angegebenen Zeichencodes (von 0 bis 255) in einen Text um und gib diesen zurück.
Beispiel:
%XMP_StrChar(65,66,67,13,10,49,50,51)
Ausgabe:
ABC
123
|
%XMP_StrCheck(Text, Prüfung,
[alternative Zeichen])
|
Überprüft, ob der angegebenenen "Text" aus bestimmten Zeichen besteht.
Der Parameter "Prüfung" kann folgende Werte haben:
U -> (Upper) Prüft, ob nur Großbuchstaben im "Text" enthalten sind.
L -> (Lower) Prüft, ob nur Kleinbuchstaben im "Text" enthalten sind.
N -> (Numeric) Prüft, ob nur Zahlen im "Text" enthalten sind.
Im Parameter "alternative Zeichen" können zusätzliche Zeichen eingegeben werden, die im "Text" enthalten sein dürfen.
Wenn der "Text" dem Muster entspricht, wird "1" zurück gegeben, anderenfalls "0".
Beispiel:
%XMP_StrCheck('Hallo','L')
%XMP_StrCheck('Hallo','UL')
%XMP_StrCheck('Hallo, das ist ein Test','UL',' ,')
%XMP_StrCheck('123-456.789','N','-.')
Ausgabe:
0
1
1
1
|
|
%XMP_StrCount(Text, Suchtext, [GroßKlein])
|
Gibt die Anzahlder Fundstellen von "Suchtext" in "Text" zurück.
Ist "GroßKlein" angegeben und hat das Argument den Wert "1", dann wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiel:
%XMP_StrCount("Abc ABC abC abc","abc")
%XMP_StrCount("Abc ABC abC abc","abc",1)
Ausgabe:
1
5
|
|
%XMP_StrDup(Text, Anzahl)
|
Fügt den "Text" mehrmals aneinander. Das Argument "Anzahl" bestimmt, wie oft der Text angehängt werden soll.
Beispiel:
%XMP_StrDup("=-",20)=
Ausgabe:
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
|
%XMP_StrIns(Originaltext, Text,
Start/Ausrichtung], [Länge])
|
Fügt den "Text" in den "Originaltext" ein.
Mit "Start" wird die Startposition des Textes angegeben, "Länge" bezeichnet die Anzahl der Zeichen, die im Originaltext überschrieben werden sollen.
Der Standardwert von "Start" ist "1" und von "Länge" "0".
An Stelle einer Startposition ("Start"), kann auch eine Ausrichtungsangabe verwendet werden, die den "Text" innerhalb des "Originaltextes" ausrichtet und diesen dabei überschreibt. Folgende Ausrichtungen sind möglich:
L -> Linksbündig
R -> Rechtsbündig
M -> Mittige Ausrichtung, wobei bei einer ungeraden Zeichenanzahl der Text mehr links ausgerichtet wird.
N -> Mittige Ausrichtung, wobei bei einer ungeraden Zeichenanzahl der Text mehr rechts ausgerichtet wird.
Beispiel:
%XMP_StrIns("123456789","ABC")
%XMP_StrIns("123456789","ABC","R")
%XMP_StrIns("123456789","ABC","L")
%XMP_StrIns("123456789","ABC",4)
%XMP_StrIns("123456789","ABC",4,1)
%XMP_StrIns("123456789","ABC",4,999)
Ausgabe:
ABC123456789
123456ABC
ABC456789
123ABC456789
123ABC56789
123ABC
|
|
%XMP_StrItem(Text, Trennzeichen, Eintrag)
|
Liest einen "Eintrag" aus einem "Text" aus, der mit einem bestimmten "Trennzeichen" getrennt ist.
Beispiel:
%XMP_StrItem("123#ABC#XYZ","#",2)
Ausgabe:
ABC
|
|
%XMP_StrItem(Text, Trennzeichen)
|
Ermittelt die Anzahl der Einträge in einem "Text", die mit "Trennzeichen" voneinander getrennt sind.
Beispiel:
%XMP_StrItemCnt("123#ABC#XYZ","#")
Ausgabe:
3
|
|
%XMP_StrLeft(Text, Anzahl)
|
Gibt eine bestimmte "Anzahl" von Zeichen aus dem "Text" zurück, beginnend beim ersten Zeichen.
Beispiel:
%XMP_StrLeft("123456789",3)
Ausgabe:
123
|
|
%XMP_StrLen(Text)
|
Ermittelt die Länge des angegebenen Textes.
Beispiel:
%XMP_StrLen("ABCEDEF")
Ausgabe:
7
|
|
%XMP_StrLines(Text, [Start], [Anzahl])
|
Liest aus dem "Text" ab der Zeile "Start" eine bestimmte "Anzahl" von Zeilen aus und gibt diese als Ergebnis zurück.
Wird "Start" oder "Anzahl" weggelassen, wird in beiden Fällen eine Zeile angenommen. Der Aufruf des Makros nur mit einem Text gibt somit die erste Zeile des Textes aus.
Beispiel:
%XMP_StrLines("%TEXT",2,2)
Ausgabe:
Zeile2
Zeile3
|
|
%XMP_StrLnCnt([Text])
|
Ermittelt die Anzahl der Zeilen im angegebenen "Text".
Wird "Text" nicht angegeben, wird der Nachrichtentext der Originalnachricht verwendet.
Beispiel:
%XMP_StrLnCnt
%XMP_StrLnCnt("")
%XMP_StrLnCnt("%_VAR"
Ausgabe:
25
0
3
|
|
%XMP_StrMid(Text, Start, [Anzahl])
|
Gibt eine bestimmte "Anzahl" von Zeichen aus dem "Text" zurück, beginnend beim Zeichen "Start".
Wird "Anzahl" nicht angegeben, werden alle Zeichen nach "Start" zurückgegeben.
Beispiel:
%XMP_StrMid("123456789",3,4)
%XMP_StrMid("123456789",3)
Ausgabe:
3456
3456789
|
|
%XMP_StrPos(Text, Suchtext, [GroßKlein])
|
Ermittelt die Position des ersten Vorkommens des "Suchtextes" im "Text".
Ist unter "GroßKlein" der Wert "1" eingetragen, wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiel:
%XMP_StrPos("AbcABCabc","ABC")
%XMP_StrPos("AbcABCabc","ABC",1)
Ausgabe:
4
1
|
%XMP_StrRepl(Text, Suche, Neu,
GroßKlein], [Alle])
|
Ersetzt alle Vorkommen von "Suche" im "Text" gegen "Neu".
Ist unter "GroßKlein" der Wert "1" eingetragen, wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Ist "Alle" auf den Wert "1" gestellt, wird nach dem Ersetzen nochmals geprüft, ob durch den voran gegangenen Ersetzungsvorgang neue Fundstellen entstanden sind. Auch hier wird die Angaben "GrossKlein" beachtet.
Achtung: Bei der Verwendung von "Alle" muss darauf geachtet werden, dass keine "Endlos-Schleifen" entstehen, z.B. durch:
"%XMP_StrRepl("XxXxXxXxXxXxXx","X","x",1,1)"!
Beispiel:
%XMP_StrRepl("AbcABCabc","ABC","Xyz")
%XMP_StrRepl("AbcABCabc","ABC","Xyz",1)
%XMP_StrRepl("XxXxXxXxXxXxXx","XX","x",1,1)
Ausgabe:
AbcXyzabc
XyzXyzXyz
x
|
|
%XMP_StrRev(Text)
|
Gibt den "Text" in umgekehrter Reihenfolge zurück.
Beispiel:
%XMP_StrRev("Hallo")
Ausgabe:
ollaH
|
|
%XMP_StrRight(Text, Anzahl)
|
Gibt eine bestimmte "Anzahl" an Zeichen aus dem "Text" zurück, beginnen beim letzten Zeichen.
Beispiel:
%XMP_StrRight("123456789",4)
Ausgabe:
6789
|
%XMP_StrTr(Text, Suche, [Ersetze],
[Optionen])
|
Ersetzt im angegebenenen "Text" alle Zeichen, die in der Zeichenfolge "Suche" angegeben sind gegen jene Zeichen in "Ersetze", die sich an der selben Position befinden. Das bedeuted, dass das erste Zeichen in "Suche" gegen das erste Zeichen in "Ersetze" ausgetaucht wird, das zweite Zeichen gegen das zweite Zeichen usw.
Wird "Ersetze" nicht angegeben oder ist "Ersetze" eine leere Zeichenfolge, werden alle Zeichen in "Suche" aus dem "Text" gelöscht. (Entspricht auch der Option "D".)
Die Angaben im Parameter "Suche" und "Ersetze" müssen denen von %XMP_StrC entsprechen. Somit ist auch die Angabe von Sonderzeichen möglich.
Als "Optionen" können folgende Werte verwendet werden:
D -> Entfernt alle Zeichen in "Suche" aus dem "Text". Die Zeichenfolge in "Ersetze" wird dabei nicht beachtet.
L - > Es wird bei der Suche nicht zwischen Groß- und Kleinschreibung unterschieden.
Beispiel:
%XMP_StrTr("HALLO","loh","104")
%XMP_StrTr("HALLO","loh","104","L")
%XMP_StrTr("Hallo","HL")
%XMP_StrTr("HALLO","Hl","XXX","DL")
Ausgabe:
HALLO
4A110
allo
AO
|
%XMP_StrTrim(Text, [LinksRechts],
[Zeichentypen])
|
Entfernt alle Leer- und Steuerzeichen am Beginn bzw. am Ende eines "Textes". Zusätzlich wird auch das Zeichen 160 (0xA0) entfernt, das in HTML-Mails manchmal an Stelle eines Leerzeichens verwendet wird.
Um nur links oder rechts Leerzeichen zu entfernen, kann unter "LinksRechts" der Wert "L" für links oder "R" für rechts angegeben werden.
Mit dem Parameter "Zeichentypen" können die Zeichentypen angegeben werden, die entfernt werden sollen. Folgende Zeichentypen können angegeben werden:
(Leerzeichen) -> Entfernt alle Leer- und Steuerzeichen, sowie das Zeichen 160 (0xA0). Dies ist der Standard, wenn der Parameter "Zeichentypen" nicht angegeben wurde.
A -> Entfernt alle Großbuchstaben
a -> Entfernt alle Kleinbuchstaben
1 -> Entfernt alle Zahlen
! (Rufzeichen) -> Entfernt alle Satz- und druckbaren Sonderzeichen
8 -> Entfernt alle 8-Bit-Zeichen
S -> Entfernt alle nationalen Sonderzeichen (ab 0xBF)
Es können auch Kombinationen verwendet werden, z.B. "Aa 1", für Buchstaben, Leerzeichen und Zahlen.
Beispiel:
|%XMP_StrTrim(" ABC ")|
|%XMP_StrTrim(" ABC ","L")|
|%XMP_StrTrim(" ABC ","R")|
%XMP_StrTrim("Betrag: 129,- Euro",""," Aa!")
%XMP_StrTrim("Betrag: 9,90 Euro",""," Aa!")
Ausgabe:
|ABC|
|ABC |
| ABC|
129
9,90
|
|
%XMP_StrWordCnt(Text)
|
Dieses Makro gibt die Anzahl der Wörter im angegebenen "Text" zurück.
Als Trennzeichen werden diverse Steuer- und Satzzeichen verwendet. Darunter Punkt, Beistrich, Strichpunkt, Rufzeichen, Fragezeichen und diverse Klammern.
Beispiel:
%XMP_StrWordCnt("Wort1, Wort-2!Wort3.Wort4 Wort_5")
Beispiel-Ausgabe:
5
|
|
%XMP_StrWrap(Text, [Breite], [Ausrichtung])
|
Bricht den angegebenen "Text" nach 70 Zeichen um. Wird "Breite" angegeben, erfolgt der Umbruch nach dieser Breite.
Als Umbruchszeichen werden Leerzeichen, Tabulatoren und Trennungsstriche erkannt. Innerhalb von doppelten und einfachen Anführungszeichen wird nicht umgebrochen!
Das interne Makro %WRAPPED bricht nur den ersten Absatz eines Textes um. Die Funktion %XMP_StrWrap formatiert den gesamten Text neu.
Als dritter Parameter kann optional die Ausrichtung des Textes angegeben werden. Zur Verfügung stehen folgende Optionen:
L -> Richtet den Text links aus (Vorgabe, falls nicht angegeben).
R -> Richtet den Text rechts aus.
C -> Richtet den Text mittig aus (zentriert).
J -> Richtet den Text so aus, dass er die gesamte Breite ausfüllt.
Beispiel:
%XMP_StrWrap("%CLIPBOARD",35)
Beispiel-Ausgabe:
Am Beginn jeder Makro-Beschreibung
ist die Syntax des Makros
angeführt. Jene Argumente, die in
eckigen Klammern stehen können
weggelassen werden. In diesem Fall
werden die Standardwerte
verwendet. Es dürfen aber immer
nur die hintersten Argumente
entfallen.
|
|
%XMP_UrlDec(URL)
|
Demaskiert in der "URL" Sonderzeichen, die vorher mit %XMP_UrlEnc maskiert wurden.
Beispiel:
%_TMP=#%XMP_UrlEnc("mailto:test@tester.com?subject=Test Subjekt")#%-
%_TMP
%XMP_UrlDec("%_TMP")%-
Ausgabe:
mailto%3Atest%40tester%2Ecom%3Fsubject%3DTest%20Subjekt
mailto:test@tester.com?subject=Test Subjekt
|
|
%XMP_UrlEnc(URL, [Art])
|
Maskiert in der "URL" bestimmte Zeichen, die nicht in einer URL vorkommen dürfen. Dieses Makro kann auch für "mailto:"-Links verwendet werden.
Während der Link "mailto:test@tester.com?subject=Das ist ein Test" nur zum Betreff "Das" führt, wird durch den maskierten Link "mailto:test@tester.com?subject=Das%20ist%20ein%20Test" der Betreff "Das ist ein Test" richtig angezeigt.
Das optionale Argument "Art" bestimmt die Art der Maskierung:
& -> Ersetzt alle & gegen "&", sonst wird der Hexadezimalwert verwendet.
< oder > -> Ersetzt alle "<" und ">"-Zeichen gegen "<" bzw. ">", sonst gegen den Hexadezimalwert.
+ -> Ersetzt alle Leerzeichen gegen ein Plus-Zeichen, sonst werden Leerzeichen mit "%20" maskiert.
Beispiel:
%XMP_UrlEnc("Test & Test")
%XMP_UrlEnc("Test & Test","&")
%XMP_UrlEnc("Test & Test","&<")
%XMP_UrlEnc("Test & Test",">&")
%XMP_UrlEnc("Test & Test","+&<")
Ausgabe:
Test%20%3Caaa%40bbb%2Ecom%3E%20%26%20Test
Test%20%3Caaa%40bbb%2Ecom%3E%20&%20Test
Test%20<aaa%40bbb%2Ecom>%20&%20Test
Test%20<aaa%40bbb%2Ecom>%20&%20Test
Test+<aaa%40bbb%2Ecom>+&+Test
|
|
%XMP_XtrEMLs([Text], [Trennzeichen])
|
Liest alle E-Mail Adressen aus dem "Text" aus und gibt sie, getrennt mit dem angegebenen "Trennzeichen" zurück.
Ist "Text" nicht angegeben oder leer, wird der Nachrichtentext verwendet. Wurde kein "Trennzeichen" festgelegt, wird ein Windows-Zeilenumbruch (0x0D + 0x0A) verwendet.
|
%XMP_XtrURLs([Text], [Trennzeichen],
[Suchtext])
|
Liest alle URLs aus dem "Text" aus und gibt sie, getrennt mit dem angegebenen "Trennzeichen" zurück.
Ist "Text" nicht angegeben oder leer, wird der Nachrichtentext verwendet. Wurde kein "Trennzeichen" festgelegt, wird ein Windows-Zeilenumbruch (0x0D + 0x0A) verwendet.
Das Argument "Suchtext" gibt einen Text innerhalb der URL an, von dem aus die Länge der URL ermittelt wird. Wird "Suchtext" gefunden, sucht das Makro nach dem ersten Zeichen links und rechts von "Suchtext", das nicht in einer URL vorkommen darf. "Suchtext" ist standardmäßig auf "https://" eingestellt. Andere Angaben, wie etwa "www." oder "ritlabs.com" sind ebenfalls möglich.
|
|