FG Mit der Pro-Lizenz können auch eigene Funktionen mit beliebigen Parametern definiert und verwendet werden.

 

Um eine Funktion zu definieren, wird sie als Unterprogramm angelegt. Dieses beginnt mit der Marke

 

::Funktion.XX(Wert1;Wert2)

 

wobei XX für den Funktionsnamen und Wert1 und Wert2 für die Parameter stehen. Diese Namen können natürlich beliebig gewählt werden. Das Unterprogramm kann die übergebenen Werte in den Parameter-Variablen (hier [Wert1] und [Wert2]) verwenden.

Sollten im Hauptprogramm bereits Variablen dieses Namens vorkommen, könnte es zu Nebeneffekten kommen. Aus diesem Grund sollte in der Marke der Funktion die Option "Lokale Variablen" angekreuzt werden. Hierdurch werden die Variablen des Hauptskripts nicht berührt, da die hier verwendeten Variablen nur lokale Gültigkeit haben. Variablen des aufrufenden Skripts können dann mit [cX.Muttervariablen.X] erreicht werden.

 

Abgeschlossen wird das Unterprogramm mit einem Beende/Zurück-Befehl. Das Ergebnis der Funktion wird dort als Rückgabewert angegeben. Aus Kompatibilitätsgründen kann es auch in die Variable [cX.Funktion.XX] eingesetzt werden, wobei XX wieder für den Funktionsnamen steht.

 

Beim Aufruf der Funktion können einzelne Parameter auch weggelassen werden, wodurch der Inhalt der entsprechenden Variablen innerhalb der Funktion dann leer ist.

Wahlweise können für solche optionalen Parameter auch Standardwerte angegeben werden. Hierzu wird in der Marke einfach Variablenname=Standardwert geschrieben, in obigem Beispiel etwa Wert2=1. Wird dieser Parameter beim Aufruf nicht mit angegeben, ist der Inhalt von [Wert2] innerhalb der Funktion dann 1.

 

Die Verwendung einer so deklarierten Funktion erfolgt wie bei anderen Platzhaltern auch in beliebigen Ausdrücken, in denen

[cX.Funktion.XX(Parameter1;Parameter2;...;ParameterN)]

eingesetzt wird. Die Parameterliste ist immer mit Semikolons zu trennen.

 

Wird im Marke-Befehl ein Kommentar eingetragen, erscheint dieser als Funktionsbeschreibung in der Variablenauswahl. Andernfalls wird der Text des ggf. vor der Marke stehenden **Kommentar-Befehls hierfür verwendet.

 

Ein Beispiel:

Es soll eine Funktion erstellt werden, die den Mittelwert von zwei Werten errechnet.

Um die Funktion namens "Mittelwert" mit den Eingabeparametern "Wert1" und "Wert2" anzulegen, wird folgende Marke definiert:

::  Funktion.Mittelwert(Wert1;Wert2)

Die folgenden Zeilen berechnen nun das Ergebnis der Funktion aus den beiden Werten und geben das Resultat im Beende/Zurück-Befehl zurück.

 

 

Die so deklarierte Funktion kann nun im Skript beliebig eingesetzt werden. Um etwa den Mittelwert von 2 und 4 zu ermitteln, kann der folgende Platzhalter verwendet werden:

[cX.Funktion.Mittelwert(2;4)]

 

 

Variable Parameterliste FG

Obwohl in der Funktionsmarke üblicherweise die zu übergebenden Parameter vorgegeben werden, können beim Aufruf unabhängig davon beliebig viele Parameter übergeben werden. Die Anzahl der übergebenen Parameter steht innerhalb der Funktion in

[cX.Parameter.Anzahl]

 

Die Parameter selbst können aus

 [cX.Parameter.Wert(n)]

ausgelesen werden, wobei für n die Parameternummer angegeben wird (1..Anzahl).

Mögliche andere Schreibweisen sind cX.Parameter.n oder cX.Parameter(n).

 

Beispiel:

Die folgende Funktion berechnet die Summe der übergebenen Parameter:

Hinweis: Die Summe könnte auch direkt über die Sum()-Funktion berechnet werden.

 

 

Wird nun im Skript etwa folgender Platzhalter eingesetzt:

 [cX.Funktion.Summe(2;3;5;10)]

berechnet die Funktion die Summe der Parameter und liefert als Ergebnis 20 zurück.

 

 

Funktionsauswahl:

Die im Skript deklarierten Funktionen werden nebst Erläuterung in der Variablenauswahl unter "Funktionen" angezeigt. Die Erläuterung wird der Kommentarzeile entnommen, die unmittelbar unter der Deklarationsmarke steht, sofern deren Eigenschaft Info nicht gefüllt ist.. Aus diesem Grund sollte jede Funktion mit einem erklärenden Kommentar beginnen.

 

 

Hier der cX4Web-Code für die oben gezeigten und einige weitere Beispiele:

 

 

 

---

cX-Webseite: http://www.clickexe.net