<<

Inhaltsverzeichnis

Suchen

>>

 

FUNCTION

 

 

Anweisung

 

 

Syntax:

FUNCTION FN<Name>[$ | %] ([<Variable>[,<Variable>]...] )

                 … Anweisungen …

                 RETURN <Ausdruck>

ENDFUNC

 

<Name>

= <NAME>

<Variable>

= <VARIABLE>

<Ausdruck>

= <AUSDRUCK>

 

Bedeutung:

Deklariert eine Funktion.

 

Funktionen können an jeder beliebigen Stelle im Makro deklariert werden, aber nicht innerhalb von Blöcken IF ... THEN, WHILE ... DO, ON ERROR ... END, usw.).

 

Der Funktionsname muss mit FN... beginnen.

 

Der Typ der Funktion (String, numerisch, integer) wird durch die Schreibweise definiert: Endet der Funktionsname mit '$', so definiert dies eine String-Funktion. '%' bedeutet integer, Buchstabe und Ziffer bedeuten numerisch (double).

 

Es können beliebig viele Parameter angegeben werden. Der Typ der einzelnen Parameter ergibt sich wieder aus deren Schreibweise. Es sind auch Funktionen ohne Parameter zulässig.

 

Folgende Anweisungen sind in einer Funktion nicht zulässig:

QUIT

MACRO

GOTO #

FIELD

DIM

SHARED

REPEAT

NEXTFIELD

ENDPROG

ENDREP

 

Jede Funktions-Deklaration muss mit ENDFUNC abgeschlossen werden.

 

Funktionen liefern als Ergebnis immer einen Wert und können deshalb nicht auf der linken Seite einer Zuweisung vorkommen.

 

Mit der Anweisung RETURN <Ausdruck> wird der Ergebniswert festgelegt und die Funktion beendet.

 

<Ausdruck> muss vom selben Typ wie die Funktion sein. Lediglich numerisch und integer können gegenseitig vertauscht werden.

 

Die letzte Anweisung in der Funktions-Deklaration vor ENDFUNC muss die Anweisung RETURN <Ausdruck> sein.

 

Beispiel:

FUNCTION FNMAX%(I%,J)

  IF I%<J

  THEN RETURN J

  ELSE RETURN I%

  ENDIF   <←> ist nicht zulässig. Letzte Anweisung muss RETURN sein.

ENDFUNC

 

Richtig ist:

 

FUNCTION FNMAX%(I%,J)

  IF I%<J

  THEN RETURN J

  ENDIF

  RETURN I%

ENDFUNC

 

Funktionen können an jeder beliebigen Stelle in beliebiger Schachtelungstiefe aufgerufen werden. Als Parameter können beliebige Ausdrücke übergeben werden. Der Typ des Ausdrucks muss jeweils mit dem Typ des Parameters in der Funktions-Deklaration übereinstimmen. Alle Parameter werden ‘by value’ an die Funktion übergeben. Dies hat zur Folge, dass bei einer Wertzuweisung an einen Parameter innerhalb der Funktions-Deklaration der Wert der aufgerufenen Variablen nicht verändert wird.

 

Parameter:

Name

Name der Funktion

Variable

Funktionsvariable

Ausdruck

Rückgabewert der Funktion

 

Beispiel:

FUNCTION FN_DATUM_ZEIT$(TYP%)

  IF TYP% = 1

  THEN RETURN DATEG$+" "+TIME$

  ENDIF

  RETURN DATEG8$+" "+TIME$

ENDFUNC

...

D$ = FN_DATUM_ZEIT$(0)

 

Siehe auch:

RETURN