✕
✕

Equals

TwinCAT TIA
Werkzeuge String Funktionen

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

Überprüft ob zwei Texte gleich sind.

Parameter:

    StrA
    Der erste Text für den Vergleich.
    StrB
    Der zweite Text für den Vergleich
    IgnoreCase
    Eine boolesche Variable, die angibt ob die Groß-/Kleinschreibung beim Vergleich ignoriert werden soll oder nicht.

Rückgabewert:

    Equals
    Eine Struktur-Variable vom Typ OpcMethodReturnValueBoolean. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eine boolesche Variable, die angibt, ob beide Texte identisch sind.

Beispiele:

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

Beckhoff Parameter:

    bStringEquals
    Eine boolesche Variable, über welche die Ausführung des Equals-Befehls getriggert werden kann.
    OutputDataStringEquals
    Eine Instanz der "ST_BoolOutputData" Struktur in welche der Rückgabewert der Equals-Methode geschrieben wird.
    hrStringEquals
    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.
    StringOne
    Die erste Zeichenkette vom Typ "STRING(80)" für den Vergleich.
    StringOneLength
    Die Länge der ersten zu vergleichenden Zeichenketten.
    StringTwo
    Die zweite Zeichenkette vom Typ "STRING(80)" für den Vergleich.
    StringTwoLength
    Die Länge der zweiten zu vergleichenden Zeichenketten.
    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
     bStringEquals   : BOOL;
     OutputDataStringEquals : ST_BoolOutputData;
     hrStringEquals   : HRESULT;

     fbStringOperations : FB_StringOperations;
END_VAR

hrStringEquals := fbStringOperations.StringEquals(
      bExecute    := bStringEquals, 
      ConnectionHandle := depragSmartConnection.ConnectionHandle,
      StringOne   := 'Ich bin ein String',
      StringOneLength  := SIZEOF('Ich bin ein String'),
      StringTwo   := 'String',
      StringTwoLength  := SIZEOF('String'),
      IgnoreCase   := TRUE, 
      OutputData   => OutputDataStringEquals);
IF hrStringEquals <> S_FALSE THEN 
      bStringEquals := 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.