Deklaration eines Datentyps mit benannten Werten (Enums) in ST
logi.CAD 3 bietet als Alternative den Enum-Editor, um Datentypen mit benannten Werten (auch als →Enums bezeichnet) anzuzeigen und zu bearbeiten – dabei müssen Sie die folgende Syntax nicht kennen.
TYPE
name_1 : data-type (name_e1 := value_1, name_e2 := value_2, ..., name_en := value_n) := initial-value;
name_2 : data-type (name_e1 := value_1, name_e2 := value_2, ..., name_en := value_n) := initial-value;
...
END_TYPE
Bedeutung |
Deklaration eines oder mehrerer →Datentypen mit benannten Werten (auch als →Enums bezeichnet), wobei name_1, name_e1 usw. →IEC-Bezeichner sein müssen Diese Deklaration ist innerhalb der Deklaration eines anwenderdefinierten Datentyps (TYPE ... END_TYPE) möglich. Mit dem optionalen →Initialisierungswert weisen Sie dem Datentyp einen Wert zu. Bei diesem Wert kann es sich ebenfalls um einen konstanten Ausdruck handeln, also z.B. ein benanntes Element (siehe Beispiel Colors1) oder ein zum Datentyp passendes Literal (siehe Beispiel Colors2). Falls kein Initialisierungswert für den Datentyp definiert ist, wird das erste Element als Initialisierungswert verwendet (siehe Beispiel TrafficLight). Abweichungen von IEC-Norm Sie müssen den Basistyp in logi.CAD 3 immer angeben. Dies steht im Gegensatz zur IEC-Norm, wo der Basistyp optional ist. Ein Datentyp mit benannten Werten darf dort verwenden werden, wo auch der Basistyp verwendet werden darf. Beispiel: Der Datentyp TrafficLight aus dem folgenden Beispiel ist als Eingangsdatentyp für den ADD-Baustein zulässig. |
logi.CAD 3 bietet außerdem die Möglichkeit, zusätzliche Daten bei der Deklaration anzugeben. Siehe "Beschreibung, Kommentar, JSON-String oder Typ für Variablen oder Datentypen angeben" für Details.
TYPE
TrafficLight : INT
(Red := 1, Yellow:= 2, Green := 3);
(* 'Red' wird als Initialisierungswert für 'TrafficLight' verwendet. *)
Colors1 : DWORD
(Red := 16#00FF0000, Green := 16#0000FF00, Blue := 16#000000FF) := Colors1#Green;
(* 'Green' wird als Initialisierungswert für 'Colors1' verwendet. *)
Colors2 : DWORD
(Orange := 16#00FF7F00, Pink := 16#00FF33FF, Red := Colors1#Red) := 16#00990000;
(* '16#00990000' wird als Initialisierungswert für 'Colors2' verwendet. *)
END_TYPE
Verwendung der benannten Werte
Verwenden Sie die folgende Syntax, um einen benannten Wert eindeutig in einem Editor anzusprechen (z.B. im ST-Editor): name_1#name_e1 (wobei name_1 der Name des Enums ist und name_e1 der Name des Elements) – Beispiel: TrafficLight#Red
logi.cals empfiehlt Ihnen, benannte Werte immer mit dem eindeutigen Namen anzusprechen. So vermeiden Sie spätere Konflikte beim Bearbeiten der Anwendung – falls z.B. ein benannter Wert auch in einer neu installierten Bibliothek verwendet wird.
Falls logi.CAD 3 den benannten Wert eindeutig aus dem Kontext ableiten kann, ist es aber möglich, nur den benannten Wert anzugeben. Siehe Yellow und Green im folgenden Beispiel, für das eine Deklaration wie unter "Deklaration eines Datentyps mit benannten Werten (Enums) in ST" erforderlich ist.
VAR
Var1 : TrafficLight;
Var2 : STRING[20];
END_VAR
IF Var1 = TrafficLight#Red THEN (* OK, da eindeutiger Zugriff *)
Var2 := 'STOP';
END_IF;
IF Var1 = Yellow THEN (* OK, da 'Var1' den Kontext für 'Yellow' vorgibt; empfohlen ist jedoch die Verwendung des eindeutigen Namens 'TrafficLight#Yellow' *)
Var2 := 'BEWARE';
END_IF;
IF Var1 = Green THEN (* OK, obwohl 'Green' nicht eindeutig ist, da 'Var1' den Kontext vorgibt; empfohlen ist jedoch die Verwendung des eindeutigen Namens 'TrafficLight#Green' *)
Var2 := 'WALK';
END_IF;
IF Var1 = 16#00000000 THEN (* OK, da auch andere Werte als die benannten Werte zulässig sind *)
Var2 := 'No traffic light';
END_IF;
Abhängig von Ihrer logi.CAD 3-Konfiguration (d.h., von der Start-Option lc3.expensive.enum.resolving.enable) können Sie einen benannten Wert möglicherweise ohne den eindeutigen Namen angeben, auch wenn der Kontext nicht bekannt ist. In diesem Fall muss der benannte Wert aber eindeutig sein. Beachten Sie, dass sich die Performance beim Speichern, Importieren und Öffnen der Objekte und/oder der Projekte jedoch verschlechtern kann. Falls Sie daran interessiert sind, die aktuelle Konfiguration zu ändern, kontaktieren Sie Ihren System-Integrator und klären Sie die möglichen Auswirkungen dieser Start-Option.