Skip to main content

Variable: VAR_GENERIC CONSTANT

Konstante generische Variable

Eine generische Konstante ist eine Variable im Deklarationsbereich VAR_GENERIC CONSTANT eines Funktionsbausteins, der erst bei der Deklaration der Funktionsbaustein-Instanz definiert wird.

Syntax: Deklaration des Funktionsbausteins

FUNCTION_BLOCK <function block name>
VAR_GENERIC CONSTANT
    <generic constant name> : <integer data type> := <initial value>; //Initial value will be oberwritten
END_VAR
;

Die generische Konstante (ganzzahliger Datentyp) kann innerhalb eines Funktionsbausteins wie üblich verwendet werden. Beispielsweise können Sie die Konstante für die Größe von Arrays oder die Länge von Strings verwenden. Der Initialwert <initial value> wird nur für Compile-Prüfungen benötigt. Zur Laufzeit wird der Wert überschrieben.

Syntax: Deklaration der Funktionsbaustein-Instanz

PROGRAM PLC_PRG
VAR
    <fb instance name> : <function block name> < <literal> >;
    <fb instance name> : <function block name> <( <expression> )>;
END_VAR
;

Bei der Deklaration der Funktionsbaustein-Instanzen wird der Konstanten ein spezifischer Wert zugewiesen, der nur für diese Instanz gültig ist. Dafür wird dem als Datentyp fungierenden Funktionsbaustein <function block name> der Wert <literal> in spitzen Klammern angehängt.

Alternativ dazu kann ein Ausdruck <expression> angehängt werden. Dieser muss dann allerdings in runden Klammern stehen, da es bei einem Ausdruck erlaubt ist, Symbole wie < oder > zu verwenden. Sonst ist die Eindeutigkeit des Codes nicht mehr gewährleistet.

Beispiel 90. Beispiel: Generischer Funktionsbaustein mit parametrierbarer Arrayvariable

Der folgende Code zeigt, wie ein Funktionsbaustein zu definieren ist, der Arrays beliebiger Länge verarbeiten kann. Der Funktionsbaustein verfügt über ein Array mit einer generischen, aber konstanten Länge. Mit "konstant" ist gemeint, dass, obwohl jede Funktionsbaustein-Instanz in ihrer Arraylänge variiert, diese während der Lebensdauer des Objekts konstant ist.

Ein solches Konstrukt ist beispielsweise für einen Bibliotheksprogrammierer von Vorteil, der einen generischen Bibliotheksbaustein implementieren möchte.

FUNCTION_BLOCK FB_MyString 
VAR_GENERIC CONSTANT
    maxlen : UDINT := 1;
END_VAR
VAR
    test : ARRAY[0..maxlen-1] OF BYTE;
END_VAR
;
PROGRAM PLC_PRG
VAR CONSTANT
    cconst: DINT := 1000;
END_VAR
VAR    
    fbMyString1 : FB_MyString<100>;
    fbMyString2 : FB_MyString<(2 * cconst)>;
    arrMyString : ARRAY [0..5] OF FB_MyString<100>;
END_VAR
;


Vererbung

Ein Funktionsbaustein mit generischen Konstanten kann auch die Vererbungskonstrukte EXTENDS und IMPLEMENTS verwenden.

Anmerkung

Achten Sie beim Implementieren darauf, dass erst die Deklaration der generischen Konstanten eingefügt wird und dann EXTENDS und IMPLEMENTS nachfolgen. Das ist gewöhnungsbedürftig, hat aber den Grund, dass generische Konstanten auch bei Basisklassen verwendet werden können.

Beispiel 91. Beispiel
INTERFACE IString 
METHOD Append : BOOL 
VAR_INPUT     
    strAppend : IString; 
END_VAR 
METHOD Assign : BOOL
VAR_INPUT     
    stringIn: String; 
END_VAR 
METHOD ToString : STRING
VAR_INPUT 
END_VAR 
PROPERTY Length : DINT
FUNCTION_BLOCK MyString 
VAR_GENERIC CONSTANT        
    maxlen : UDINT; 
END_VAR 
IMPLEMENTS IString 
FUNCTION_BLOCK LongString EXTENDS MyString<1000>
FUNCTION_BLOCK MySpecialString 
VAR_GENERIC CONSTANT        
    maxlen2 : UDINT:= 1; 
END_VAR 
EXTENDS MyString<maxlen2>
METHOD ToLatin1: STRING 
PROGRAM PLC_PRG 
VAR CONSTANT     
    cconst: DINT := 1000; 
END_VAR
VAR     
    string1 : MyString<100>;
    string2 : MyString<(2 * cconst)>;
    derived1 : LongString;
    derived2 : MySpecialString<100>;
END_VAR 
string1.Assign ('Welt'); 
string2.Assign ('Hallo '); 
string2.Append(string1); 
derived2.ToLatin1('Hello World');