✕
✕

StartsWith

TwinCAT TIA
Werkzeuge String Funktionen

ns=2;s=DEPRAG Smart/Utilities/StringOperations/StartsWith

Überprüft ob ein Text mit einem bestimmten Wert startet.

Parameter:

    Value
    Der Text der am Anfang von ContainString geprüft wird.
    IgnoreCase
    Eine boolesche Variable, die angibt ob die Groß-/Kleinschreibung beim Vergleich ignoriert werden soll oder nicht.

Rückgabewert:

    StartsWith
    Eine Struktur-Variable vom Typ OpcMethodReturnValueBoolean. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eine boolesche Variable, die angibt, ob der zu suchende Text am Anfang vom Parameter ContainString auftritt.

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bStringStartsWith
    Eine boolesche Variable, über welche die Ausführung des StartsWith-Befehls getriggert werden kann.
    OutputDataStringStartsWith
    Eine Instanz der "ST_BoolOutputData" Struktur in welche der Rückgabewert der StartsWith-Methode geschrieben wird.
    hrStringStartsWith
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbStringOperations
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_StringOperations" Funktionsbausteins.
    ContainString
    Der Text der überprüft werden soll.
    ContainStringLength
    Die Länge der Zeichenkette in der gesucht werden soll.
    Value
    Der Text der am Anfang von ContainString geprüft wird.
    ValueLength
    Die Länge der Zeichenkette, die mit dem Anfang der Zeichenkette in der gesucht werden soll, verglichen wird.
    IgnoreCase
    Eine boolesche Variable, die angibt ob die Groß-/Kleinschreibung beim Vergleich ignoriert werden soll oder nicht.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
    bStringStartsWith   : BOOL;
    OutputDataStringStartsWith : ST_BoolOutputData;
    hrStringStartsWith   : HRESULT;

    fbStringOperations : FB_StringOperations;
END_VAR

hrStringStartsWith := fbStringOperations.StringStartsWith(
      bExecute     := bStringStartsWith, 
      ConnectionHandle  := depragSmartConnection.ConnectionHandle,
      ContainString   := 'Ich bin ein String',
      ContainStringLength  := SIZEOF('Ich bin ein String'),
      Value     := 'String',
      ValueLength    := SIZEOF('String'),
      IgnoreCase    := TRUE, 
      OutputData    => OutputDataStringStartsWith);
IF hrStringStartsWith <> S_FALSE THEN 
      bStringStartsWith := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.