Mit der Pro-Lizenz können nun 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. Das Unterprogramm kann die Werte in den Parameter-Variablen (hier [Wert1] und [Wert2]) verwenden.

Sollten im Hauptprogramm bereits Variablen dieses Namens vorkommen, werden diese nicht berührt, da die hier verwendeten Variablen nur lokale Gültigkeit haben. Zugriff auf Variablen des aufrufenden Skripts können jedoch mit [Muttervariablen.X] erreicht werden.

 

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

Es können auch mehrere Ergebnisse zurückgegeben werden - siehe unten.

 

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 [Funktion.XX(Parameter1;Parameter2;...;ParameterN)] eingesetzt wird. Die Parameterliste ist immer mit Semikolons zu trennen.

 

 

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 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:

[Funktion.Mittelwert 2;4]

 

 

Variable Parameterliste

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

[XX.ParameterAnzahl]

 

Die Parameter selbst können aus

 [XX.Parameter(n)]

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

 

Beispiel:

Die folgende Funktion berechnet die Summe der übergebenen Parameter:

 

 

Wird nun im Skript etwa folgender Platzhalter eingesetzt:

 [Funktion.Summierung 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. Aus diesem Grund sollte jede Funktion mit einem erklärenden Kommentar beginnen.

 

 

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

 

 

Mehrere Ergebnisse

Es ist auch möglich, mehrere Ergebnisse aus einer Funktion zurückzuliefern Hierzu werden die Ergebnisse mit ; getrennt zurückgegeben. Der Aufruf der Funktion mit [Funktion.X(Parameter)(Index)] liefert das Ergebnis Nummer Index (1-n), während der einfache Aufruf die Ergebnisliste liefert.

Beispiel Funktion mit mehreren Ergebnissen
***  Testskript für mehrere Rückgabewerte bei "Eigene Funktion" (von Franklin)
    Setze  in [Dateiname]:  'clickexe*.exe'
    Meldung  "Rückgabe gesamt zu "[Dateiname]":¶[Funktion.GetFileInfo([Dateiname])]¶¶Einzelne Rückgabewerte:¶Datei :              [Funktion.GetFileInfo([Datein ame])(1)]¶Datum/Zeit :    [Funktion.GetFileInfo([Dateiname])(2)]¶Grösse :           [Funktion.GetFileInfo([Dateiname])(3)]¶" (Titel: 'Meldung', Info, OK)
    Beende  Skript
   
::  Funktion.GetFileInfo(Dateiname)
***  Funktion liefert Als Ergebnisse Dateinamen, Datum und Größe
    Setze  in [Dateiname]:  '[Datei.Name [Dateiname]]'
    Setze  in [DateiDatum]:  '[Datei.Datum [Dateiname]§§d. mmmm yyyy]'
    Setze  in [DateiZeit]:  '[Datei.Zeit [Dateiname]]'
    Setze  in [DateiGröße]:  '[Datei.Größe [Dateiname]]'
Zurück   (Ergebnis: '[Dateiname];[DateiDatum] ([DateiZeit]);[DateiGröße]')

**cX400C5D 4D8BDBS1F4 2CMQkwCQkg VGVzdHNrcm lwdCBm/HIg bWVocmVyZS BS/GNrZ2Fi ZXdlcnRlIG JlaSAiRWln ZW5lIEZ1bm t0aW9uIiAo dm9uIEZyYW 5rbGluKQ0K MjIJMAkJIG NsaWNrZXhl Ki5leGUJPU RhdGVpbmFt ZQ0KMwkwCQ lNNjQJQjAJ VE1lbGR1bm cJIFL8Y2tn YWJlIGdlc2 FtdCB6dSAi W0RhdGVpbm FtZV0iOrZb RnVua3Rpb2 4uR2V0Rmls ZUluZm8oW0 RhdGVpbmFt ZV0pXba2RW luemVsbmUg Uvxja2dhYm V3ZXJ0ZTq2 RGF0ZWkgOi AgICAgICAg ICAgICAgW0 Z1bmt0aW9u LkdldEZpbG VJbmZvKFtE YXRlaW5hbW VdKSgxKV22 RGF0dW0vWm VpdCA6ICAg IFtGdW5rdG lvbi5HZXRG aWxlSW5mby hbRGF0ZWlu YW1lXSkoMi ldtkdy9nNz ZSA6ICAgIC AgICAgICBb RnVua3Rpb2 4uR2V0Rmls ZUluZm8oW0 RhdGVpbmFt ZV0pKDMpXb YNCjUJMAkJ Qw0KMAkwCQ 0KMTkJMAkJ IEZ1bmt0aW 9uLkdldEZp bGVJbmZvKE RhdGVpbmFt ZSkNCjEJMA kJIEZ1bmt0 aW9uIGxpZW ZlcnQgQWxz IEVyZ2Vibm lzc2UgRGF0 ZWluYW1lbi wgRGF0dW0g dW5kIEdy9t 9lDQoyMgkw CQkgW0RhdG VpLk5hbWUg W0RhdGVpbm FtZV1dCT1E YXRlaW5hbW UNCjIyCTAJ CSBbRGF0ZW kuRGF0dW0g W0RhdGVpbm FtZV2np2Qu IG1tbW0geX l5eV0JPURh dGVpRGF0dW 0NCjIyCTAJ CSBbRGF0ZW kuWmVpdCBb RGF0ZWluYW 1lXV0JPURh dGVpWmVpdA 0KMjIJMAkJ IFtEYXRlaS 5HcvbfZSBb RGF0ZWluYW 1lXV0JPURh dGVpR3L232 UNCjQ1CTAJ CSAJQVtEYX RlaW5hbWVd O1tEYXRlaU RhdHVtXSAo W0RhdGVpWm VpdF0pO1tE YXRlaUdy9t 9lXQ0K=*

 

 

---

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