:DEFINE

Verwenden Sie die Anweisung :DEFINE, um eine Variable zu definieren und den Datentyp der Variablen anzugeben. Weitere Informationen über Variablen und die Definition von Variablen als Arrays finden Sie unter Script-Variablen.

Syntax

: D[EFINE] Script-Variable, Datentyp [, Arraygröße]

Parameter

• :DEFINE
  Definiert eine Script-Variable und deklariert den Datentyp

• Script-Variable
  Name der Script-Variablen
  Format: Script-Variable
  Halten Sie die Regeln für Variablennamen ein. Weitere Informationen finden Sie unter Variablennamen.

• Datentyp
  Datentyp der Variablen
  Zulässige Werte:

  • unsigned
    Positive ganze Zahlen ohne algebraische Vorzeichen
  • signed
    Ganzzahlen mit algebraischen Vorzeichen
  • float
    Gleitkommazahlen
  • string
    String oder Text
  Weitere Informationen finden Sie unter Datentypen von Script-Variablen.

• Array-Größe
  (Optional) Anzahl von Elementen, wenn Sie die Variable als Array definieren möchten
  Format: Zahlen ohne Anführungszeichen. Sie können keine Script-Variablen verwenden.
  Zulässige Werte: 1 bis 99999
  Weitere Informationen: Arrays

Hinweise:

• Werte, die außerhalb des zulässigen Bereichs für den angegebenen Datentyp liegen, werden automatisch in den Zieldatentyp konvertiert.
• Sie können auch eine :SET-Anweisung verwenden, um eine Variable zu erstellen, aber die Variable kann nur vom Datentyp "string" oder "unsigned" sein. Weitere Informationen finden Sie unter :SET.
• Sie können einen anderen Datentypwert nur dann zuweisen, wenn die Script-Variable mit einer :SET-Anweisung erstellt wurde und der Wert eine positive Ganzzahl oder ein String ist.

Warnungen:

• Bei der Verwendung einer :DEFINE-Anweisung muss ein Datentyp angegeben werden
• Weisen Sie nur einen Wert zu, der durch den Datentyp, den Sie deklarieren, erlaubt ist

Tipp: Beachten Sie die folgenden Script-Funktionen, um den Datentyp und das Format des Werts einer Variablen zu ändern:

• CONVERT
• FORMAT

Beispiele

Die folgenden Beispiele deklarieren Variablen mit unterschiedlichen Datentypen mit :DEFINE-Anweisungen. :SET-Anweisungen weisen die Werte der Variablen zu:

: DEFINE &a#, unsigned
:DEFINE &b#, signed
:DEFINE &c#, float
:DEFINE &d#, string
:SET &a# = 12
:SET &b# = -5
:SET &c# = 0.50
:SET &d# = "string"

Das folgende Beispiel konvertiert automatisch den Datentyp des der Variablen zugewiesenen Wertes:

: DEFINE &unsigned#, unsigned
:DEFINE &string#, signed
:SET &unsigned# = 12
:SET &string# = &unsigned#

Das folgende Beispiel verwendet die Funktion CONVERT, um den Datentyp eines Wertes, der der Variablen zugewiesen ist, zu konvertieren:

:DEFINE &unsigned#, unsigned
:DEFINE &string#, signed
:SET &unsigned# = 12
:SET &string# = CONVERT(string,&unsigned#)

Das folgende Beispiel verwendet eine :SET-Anweisung, um eine Variable zu erstellen. In diesem Fall ist eine direkte Zuweisung der Werte an die Datentypen "string" oder "unsigned" möglich.

: SET &setvar# = 12
: SET &setvar2# = "string"
:SET &setvar# = &setvar2#

Das folgende Beispiel erstellt und füllt ein Array:

:DEFINE &array#, unsigned, 5
:FILL &array#[] = GET_VAR(VARA1, ARRAY)

Folgendes Beispiel rundet das Ergebnis der Rechenoperation 3.0 - 0.1 mit Hilfe der Script-Funktion "FORMAT" in einen String. Das Script berücksichtigt eine Nachkommastelle und einen allgemeinen Rechenfehler (Epsilon = 0.0000005).

: DEFINE &SCRIPT_VERSION_ORIG# , float
: DEFINE &SCRIPT_VERSION_ORIG1# , float
: DEFINE &EPSILON#, float

: SET &SCRIPT_VERSION_ORIG# = 3.0
:SET &EPSILON# = 0.0000005
:P &SCRIPT_VERSION_ORIG#
:SET &SCRIPT_VERSION_ORIG# = &SCRIPT_VERSION_ORIG# - 0.1
:P BEFORE FORMAT: &SCRIPT_VERSION_ORIG#
:SET &SCRIPT_VERSION_ORIG# = &SCRIPT_VERSION_ORIG# + &EPSILON#
:SET &SCRIPT_VERSION_ORIG# = FORMAT(&SCRIPT_VERSION_ORIG#, "0.0")
:P AFTER FORMAT: &SCRIPT_VERSION_ORIG#

Siehe auch: