:DEFINE

Verwenden Sie das Statement :DEFINE, um eine Variable zu definieren und den Datentyp der Variablen anzugeben. Sie können das :DEFINE-Statement auch verwenden, um eine Variable neu zu definieren, die bereits durch ein :SET- Statement gesetzt wurde. Weitere Informationen über Variablen und die Definition von Variablen als Arrays finden Sie unter Script-Variablen.

Syntax 

:D[EFINE] Script variable, Data type [, Array size]

Parameter

• :DEFINE
  Definiert die Variable und deklariert den Datentyp
• Script variable
  Name der Script-Variable
  Format: Script-Variable
  Befolgen Sie die Regeln für Variablennamen. Weitere Informationen finden Sie unter Variablennamen.
• Data type
  Datentyp der Variable
  Erlaubte Werte:
  • unsigned
    Positive ganze Zahlen ohne algebraische Vorzeichen
  • signed
    Ganzzahlen mit algebraischen Vorzeichen
  • float
    Gleitkommazahlen
  • string
    Zeichenfolge oder Text
  Weitere Informationen finden Sie unter Datentypen von Script-Variablen.
• Array size
  (Optional) Anzahl der Elemente, wenn Sie die Variable als Array definieren möchten
  Format: Zahlen ohne Hochkommata
  Erlaubte Werte: 1 bis 99999
  Mehr 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 ein :SET-Statement 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 einem :SET-Statement erstellt wurde und der Wert eine positive Ganzzahl oder Zeichenfolge ist.

Warnungen:

• Bei der Verwendung eines :DEFINE-Statements muss ein Datentyp angegeben werden.
• Weisen Sie nur einen Wert zu, der durch den Datentyp, den Sie deklarieren, erlaubt ist.
• Eine Deklaration von Variablen, die bereits verwendet wurden, ist nicht möglich. Dies gilt auch für die folgenden Arten von Variablen:
  • Script-Variablen
  • PromptSet-Variablen
  • Objektvariablen, inklusive der auf der Seite Variablen & Prompts eines Objektes festgelegten Definitionen

Beispiele

Die folgenden Beispiele deklarieren Variablen mit unterschiedlichen Datentypen mit :DEFINE-Statements. :SET-Statements 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 ein :SET-Statement, 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
:PBEFORE FORMAT: &SCRIPT_VERSION_ORIG#
:SET &SCRIPT_VERSION_ORIG# = &SCRIPT_VERSION_ORIG# + &EPSILON#
:SET &SCRIPT_VERSION_ORIG# = FORMAT(&SCRIPT_VERSION_ORIG#, "0.0")
:PAFTER FORMAT: &SCRIPT_VERSION_ORIG#

Mehr Informationen:

• CONVERT
• FORMAT

Siehe auch: