✕
✕

EndsWith

TwinCAT TIA
Werkzeuge String Funktionen

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

Überprüft ob ein Text mit einem anderen Text endet.

Parameter:

    Value
    Wert mit dem das Ende von ContainString überprüft wird.
    IgnoreCase
    Eine boolesche Variable, die angibt ob die Groß-/Kleinschreibung beim Vergleich ignoriert werden soll oder nicht.

Rückgabewert:

    EndsWith
    Eine Struktur-Variable vom Typ OpcMethodReturnValueBoolean. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eine boolesche Variable, die angibt, ob die zu suchende Zeichenkette am Ende der Zeichenkette, in der gesucht werden soll, auftritt.

Beispiele:

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

Beckhoff Parameter:

    bStringEndsWith
    Eine boolesche Variable, über welche die Ausführung des EndsWith-Befehls getriggert werden kann.
    OutputDataStringEndsWith
    Eine Instanz der "ST_BoolOutputData" Struktur in welche der Rückgabewert der EndWith-Methode geschrieben wird.
    hrStringEndsWith
    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 geprüft wird.
    ContainStringLength
    Die Länge der Zeichenkette in der gesucht werden soll.
    Value
    Wert mit dem das Ende von ContainString überprüft wird.
    ValueLength
    Die Länge der Zeichenkette, die mit dem Ende 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
    bStringEndsWith    : BOOL;
    OutputDataStringEndsWith : ST_BoolOutputData;
    hrStringEndsWith   : HRESULT;

    fbStringOperations : FB_StringOperations;
END_VAR

hrStringEndsWith := fbStringOperations.StringEndsWith(
      bExecute     := bStringEndsWith, 
      ConnectionHandle  := depragSmartConnection.ConnectionHandle,
      ContainString   := 'Ich bin ein String',
      ContainStringLength  := SIZEOF('Ich bin ein String'),
      Value     := 'String',
      ValueLength    := SIZEOF('String'),
      IgnoreCase    := TRUE, 
      OutputData    => OutputDataStringEndsWith);
IF hrStringEndsWith <> S_FALSE THEN 
      bStringEndsWith := 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.