Trim

TwinCAT TIA
Werkzeuge String Funktionen

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

Entfernt alle Leerraumzeichen am Anfang und Ende des angegebenen Textes.

Parameter:

    StringToTrim
    Der Text aus dem alle Leerraumzeichen am Anfang und Ende entfernt werden.

Rückgabewert:

    Trim
    Eine Struktur-Variable vom Typ OpcMethodReturnValueToolsReturnValue. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eingabe Parameter StringToTrim ohne Leerzeichen am Anfang und Ende.

Beispiele:

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

Beckhoff Parameter:

    bStringTrim
    Eine boolesche Variable, über welche die Ausführung des Trim-Befehls getriggert werden kann.
    OutputDataStringTrim
    Eine Instanz der "ST_StringOutputData" Struktur in welche der Rückgabewert der Trim-Methode geschrieben wird.
    hrStringTrim
    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.
    Value
    Die Zeichenkette vom Typ "STRING(80)" aus der alle Leerraumzeichen entfernt werde sollen.
    ValueLength
    Die Länge der Zeichenkette, aus der alle Leerraumzeichen entfernt werden sollen.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle".


VAR
    bStringTrim    : BOOL;
    OutputDataStringTrim : ST_StringOutputData;
    hrStringTrim   : HRESULT;

    fbStringOperations : FB_StringOperations;
END_VAR

hrStringTrim := fbStringOperations.StringTrim(
      bExecute     := bStringTrim, 
      ConnectionHandle  := depragSmartConnection.ConnectionHandle,
      Value     := '    Ich bin ein String',
      ValueLength    := SIZEOF('    Ich bin ein String'), 
      OutputData    => OutputDataStringTrim);
IF hrStringTrim <> S_FALSE THEN 
      bStringTrim := 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.