Seitenhistorie
Wie bereits vorgestellt können innerhalb von EVAL-Anweisungen auch Funktionen angegeben werden. Dazu gibt es im R-S einen Satz vorgefertigter Funktionen, die Sie nutzen können.
Diese Funktionen sind syntaktisch wie folgt aufgebaut:
Codeblock | ||
---|---|---|
| ||
FUNKTIONSNAME(PN1,...,PNn) |
Der FUNKTIONSNAME bezeichnet die Funktion. Der FUNKTIONSNAME kann in Klein- und Großbuchstaben oder gemischt gemischt in Klein-/Großbuchstaben geschrieben werden, eine Unterscheidung ergibt sich dadurch nicht. Nach dem FUNKTIONSNAMEN folgen dann die Zeichenfolge '()'. Innerhalb des Klammer-Paares können die Übergabeparameter der Funktion angegeben werden. PN1 bis PNn sind die Übergabeparameter der Funktion. Parameter werden immer mit " " eingeschlossen. Die Anzahl der Übergabeparameter ist von der Funktion abhängig. Es müssen immer alle erwarteten Parameter angegeben werden., manche Funktionen haben aber auch optionale Parameter. Übergabeparameter werden durch ',' getrennt und können folgende Werte annehmen:
Info | ||
---|---|---|
| ||
|
Die meisten Funktionen erwarten Parameter von einem bestimmten Datentyp und geben einen Wert in einem bestimmten Datentyp zurück. Manche Funktionen existieren für mehrere Datentypen, z.B. Add für INTEGER
(AddI), REAL
(AddR) und DATE
(AddDate). Sie müssen jeweils die Funktion verwenden, die für den vorhandenen Datentyp geeignet ist.
Kurz-Übersichtsliste der Funktionen
Im Folgenden sind alle Funktionen aufgeführt und nach Typ geordnet. Von jeder Funktion werden die verschiedenen Ausführungen aufgelistet, die unterschiedliche Datentypen als Eingangsparameter verarbeiten können. Klicken Sie auf eine Funktion, um genauere Informationen zu erhalten.
Scroll Pagebreak
Einfache mathematische Funktionen
Funktionsname
Kurz-Beschreibung
AddDate(PN1,PN2,PN3)
AddDate addiert zu einem als Input gegebenen Tagesdatum weitere Tage hinzu.
Ausführliche Beschreibung: AddDate - Funktion
Funktion | INTEGER | REAL | DATE | Beschreibung |
---|---|---|---|---|
Add |
Ausführliche Beschreibung: AddI - Funktion
AddR(PN1,...,PNn) |
AddR addiert reelle Zahlen (Gleitkommazahlen) zueinander.
Ausführliche Beschreibung: AddR - Funktion
AddDate(PN1,PN2,PN3) | Addiert 2 oder mehrere Werte bzw. addiert Tage zu einem gegebenen Datum. |
Subtrac | SubtracI(PN1,PN2, |
...,PNn |
Verknüpft alle PNs nach den Regeln des Logischen And.
Ausführliche Beschreibung: And - Funktion
ClearS(PN)
Der angegebene String wird von allen Zeichen bereinigt, die in einem File-Namen nicht vorkommen dürfen.
Ausführliche Beschreibung: ClearS - Funktion
) | SubtracR(PN1,PN2,...,PNn) | SubtDate(PN1,PN2,PN3) | Subtrahiert 2 oder mehrere Werte bzw. subtrahiert Tage von einem gegebenen Datum. |
Multiply | MultiplyI |
(PN1,PN2,...,PNn) |
Ausführliche Beschreibung: ConcatS - Funktion
MultiplyR(PN1,PN2,PN3,PN4) | — | Multipliziert PN1 mit allen folgenden Parametern. |
Divide | DivideI(PN1,PN2) |
DivideI teilt die IntergerZahl von PN1 (Dividend) durch die Integerzahl von PN2 (Divisor).
Ausführliche Beschreibung: DivideI - Funktion
DivideR(PN1,PN2) |
— | Teilt die |
Zahl von PN1 (Dividend) durch die |
Zahl von PN2 |
Ausführliche Beschreibung: DivideR - Funktion
EmptyS(PN)
EmptyS gibt an, ob Zeichen in dem String stehen.
Ausführliche Beschreibung: EmptyS - Funktion
(Divisor). | ||
Round | — | RoundR |
(PN1,PN2,PN3,PN4) |
FillS ist ein Stringfüller.
Ausführliche Beschreibung: FillS - Funktion
If(PN1,PN2,PN3)
Ausführliche Beschreibung: If - Funktion
— | Rundet eine reelle Zahl mit Nachkommastellen |
Scroll Pagebreak
Stringoperatoren
Funktion | STRING | Beschreibung |
---|---|---|
Empty | EmptyS(PN1) | Gibt 1 (true) zurück, wenn der String PN1 leer ist, ansonsten 0. |
Index | IndexS(PN1,PN2,PN3) |
Sucht in einem String das Vorkommen eines Matchstrings und gibt die Position |
des ersten Zeichens des Matchstrings im String zurück. | ||
Length | LengthS(PN) | Gibt die Länge des Strings zurück. |
Sub | SubS(PN1,PN2,PN3) |
Liefert den Wert 1 zurück, wenn der String PN1 kleiner ist als der String PN2.
Ausführliche Beschreibung: IsLessS - Funktion
Bildet vom String PN1 einen SubString, der auf Position PN2 beginnt und PN3 Zeichen lang ist. | |
Token | TokenS |
(PN1,PN2,PN3) | Liefert den |
Ausführliche Beschreibung: IsLessI - Funktion
n-ten Token aus einem String zurück, wobei 1 der erste Token ist. |
Stringmanipulation
Funktion | STRING | Beschreibung |
---|---|---|
Clear | ClearS(PN1) | Der angegebene String wird von allen Zeichen bereinigt, die in einem File-Namen nicht vorkommen dürfen. |
Fill | FillS(PN1,PN2,PN3,PN4) | Füllt einen String mit einem angegebenen Zeichen auf. |
Placeholder | PlaceholderS(PN1,...,PNn) | Tauscht im String PN1 alle %x% (x = fortlaufende Nummer) durch PNx aus. |
RemoveAll | RemoveAllS(PN1,PN2) | Entfernt jedes Vorkommen der Zeichenkette PN2 im String PN1. |
ReplaceAll | ReplaceAllS(PN1,PN2,PN3) | Tauscht jedes Vorkommen der Zeichenkette PN2 im String PN1 gegen PN3. |
ToLower | ToLowerS (PN1) | Wandelt die Großbuchstaben eines Strings in Kleinbuchstaben. |
ToUpper | ToUpperS (PN1) | Wandelt die Kleinbuchstaben eines Strings in Großbuchstaben. |
Trim | TrimS(PN1,PN2,PN3) | Entfernt nicht benötigte Zeichen vom Anfang und oder vom Ende eines Strings. |
Scroll Pagebreak
Logische Vergleiche
Funktion | STRING | INTEGER | REAL | Beschreibung |
---|---|---|---|---|
IsLess | IsLessS(PN1,PN2) | IsLessI(PN1,PN2) | IsLessR |
IsLessR(PN1,PN2)
Liefert den Wert 1 zurück, wenn die reelle Zahl PN1 kleiner ist als die reelle Zahl PN2.
Ausführliche Beschreibung: IsLessR - Funktion
IsEqualS(PN1,PN2)
Liefert den Wert 1 zurück, wenn der String PN1 gleich dem String PN2 ist.
Ausführliche Beschreibung: IsEqualS - Funktion
IsEquaII(PN1,PN2)
Liefert den Wert 1 zurück, wenn die ganze Zahl PN1 gleich der ganzen Zahl PN2 ist.
Ausführliche Beschreibung: IsEqualI - Funktion
IsEqualR(PN1,PN2)
Liefert den Wert 1 zurück, wenn die reelle Zahl PN1 gleich der realen Zahl PN2 ist.
Ausführliche Beschreibung: IsEqualR - Funktion
(PN1,PN2) | Liefert |
1 (true) zurück, wenn |
PN1 |
kleiner ist als |
Ausführliche Beschreibung: IsGreaterS - Funktion
PN2, ansonsten 0 (false) | |||
IsEqual | IsEqualS(PN1,PN2) | IsEqualI(PN1,PN2) | IsEqualR |
(PN1,PN2) | Liefert |
1 (true) zurück, wenn |
PN1 |
Ausführliche Beschreibung: IsGreaterI - Funktion
gleich PN2 ist, ansonsten 0 (false) | ||||
IsGreater | IsGreaterS(PN1,PN2) | IsGreaterI(PN1,PN2) | IsGreaterR(PN1,PN2) | Liefert |
1 (true) zurück, wenn |
PN1 größer ist als |
Ausführliche Beschreibung: IsGreaterR - Funktion
PN2, ansonsten 0 (false) | |
IsNull | IsNullS(PN1) |
Liefert den Wert 1 zurück, wenn der String PN1 kein Zeichen enthält.
Ausführliche Beschreibung: IsNullS - Funktion
IsNullI(PN1) |
Liefert den Wert 1 zurück, wenn die ganze Zahl PN1 den Wert 0 hat.
Ausführliche Beschreibung: IsNullI - Funktion
IsNullR(PN1) | Liefert |
1 (true) zurück, wenn |
PN1 |
Ausführliche Beschreibung: IsNullR - Funktion
LengthS(PN)
LengthS gibt die Länge eines Strings zurück.
Ausführliche Beschreibung: LengthS - Funktion
0 ist (bzw. ein leerer String), ansonsten 0 (false) |
Logische Operatoren
Funktion | BOOLEAN | Beschreibung |
---|---|---|
And | And(PN1 |
,...,PNn) |
MultiplyI multipliziert die Integerwerte der Parameter 2 bis n zum Parameter 1.
Ausführliche Beschreibung: MultiplyI - Funktion
Verknüpft alle PNs nach den Regeln des Logischen And. Gibt 1 zurück, wenn alle PN = true | |
If | If |
(PN1,PN2, |
Ausführliche Beschreibung: MultiplyR - Funktion
PN3) | Liefert den Wert PN2 zurück, wenn PN1 gleich 1 (true) ist, ansonsten PN3. | |
Nand | Nand(PN1,...,PNn) | Verknüpft alle PNs nach den Regeln des |
Logischen Nand. |
Ausführliche Beschreibung: Nand - Funktion
Gibt 1 zurück, wenn min. 1 PN = true | ||
Nor | Nor(PN1,...,PNn) | Verknüpft alle PNs nach den Regeln des Logischen Nor. |
Ausführliche Beschreibung: Nor - Funktion
Gibt 1 zurück, wenn alle PN = false | ||
Not | Not(PN1) | Negiert |
PN1. |
NowS(format-string)
NowS wird zum Einfügen von Datums- und Zeitangaben verwendet.
Ausführliche Beschreibung: NowS - Funktion
Or | Or(Pn1 |
,...,PNn) | Verknüpft alle PNs nach den Regeln des Logischen Or. |
Ausführliche Beschreibung: Or - Funktion
PlaceholderS(PN1,…,PNn)
Tauscht im String PN1 alle %x% (x = fortlaufende Nummer) durch PNx aus.
Ausführliche Beschreibung: PlaceholderS - Funktion
RoundR(PN1,PN2,PN3,PN4)
RoundR rundet die über PN1 angegebene reelle Zahl (Gleitkommazahlen).
Ausführliche Beschreibung: RoundR - Funktion
SepSign(PN1,PN2)
SepSign trennt bei einer Zahl mit Vorzeichen die Zahl und das Vorzeichen voneinander.
Ausführliche Beschreibung: SepSign - Funktion
SubS(PN1,PN2,PN3)
Bildet vom Platzhalter PN1 einen SubString, der auf Position PN2 beginnt und PN3 Zeichen lang ist.
Ausführliche Beschreibung: SubS - Funktion
Gibt 1 zurück, wenn min 1 PN = false |
Sonstige Funktionen
Funktion | STRING | INTEGER / REAL | Beschreibung |
---|---|---|---|
Concat |
SubtracI zieht vom Integerwert des Strings PN1 die Integerwerte aller folgenden PNs ab.
Ausführliche Beschreibung: SubtracI - Funktion
SubtracR(PN1,PN2,...,PNn)
SubtracR subtrahiert zwei reelle Zahlen (Gleitkommazahlen) voneinander.
Ausführliche Beschreibung: SubtracR - Funktion
RemoveAllS(PN1,PN2)
RemoveAllS entfernt jedes Vorkommen der Zeichenkette PN2 im String PN1.
Ausführliche Beschreibung: RemoveAllS - Funktion
ReplaceAllS(PN1,PN2,PN3)
ReplaceAllS tauscht jedes Vorkommen der Zeichenkette PN2 im String PN1 gegen PN3.
Ausführliche Beschreibung: ReplaceAllS - Funktion
TokenS(PN1,PN2,PN3)
TokenS liefert den n-ten Token aus einem String zurück, wobei 1 der erste Token ist.
Ausführliche Beschreibung: TokenS - Funktion
ToLowerS(PN1)
ToLowerS wandelt die Großbuchstaben eines Strings in Kleinbuchstaben.
Ausführliche Beschreibung: ToLowerS - Funktion
ToUpperS(PN1)
ToUpperS wandelt die Kleinbuchstaben eines Strings in Großbuchstaben.
Ausführliche Beschreibung: ToUpperS - Funktion
TrimS(PN1,PN2,PN3)
TrimS entfernt nicht benötigte Zeichen vom Anfang und oder vom Ende eines Strings.
Ausführliche Beschreibung: TrimS - Funktion
...
— | Hängt die Werte aller Parameter aneinander und gibt das Resultat als String zurück. | ||
Now | NowS(format-string) | — | Wird zum Einfügen von Datums- und Zeitangaben verwendet. |
SepSign | — | | Trennt bei einer Zahl mit Vorzeichen die Zahl und das Vorzeichen voneinander. |