✕
✕

ToUpper

TwinCAT TIA
Werkzeuge String Funktionen

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

Konvertiert alle Kleinbuchstaben des angegebenen Textes in Großbuchstaben.

Parameter:

Rückgabewert:

    ToUpper
    Eine Struktur-Variable vom Typ OpcMethodReturnValueString. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Der Parameter StringToUpper in Großbuchstaben.

Beispiele:

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

Beckhoff Parameter:

    bStringToUpper
    Eine boolesche Variable, über welche die Ausführung des ToUpper-Befehls getriggert werden kann.
    OutputDataStringToUpper
    Eine Instanz der "ST_StringOutputData" Struktur in welche der Rückgabewert der ToUpper-Methode geschrieben wird.
    hrStringToUpper
    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 zu konvertierende Zeichenkette vom Typ "STRING(80)".
    ValueLength
    Die Länge der zu konvertierenden Zeichenkette.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
    bStringToUpper   : BOOL;
    OutputDataStringToUpper : ST_StringOutputData;
    hrStringToUpper   : HRESULT;

    fbStringOperations : FB_StringOperations;
END_VAR

hrStringToUpper := fbStringOperations.StringToUpper(
      bExecute     := bStringToUpper, 
      ConnectionHandle  := depragSmartConnection.ConnectionHandle,
      Value     := 'Ich bin ein String',
      ValueLength    := SIZEOF('Ich bin ein String'), 
      OutputData    => OutputDataStringToUpper);
IF hrStringToUpper <> S_FALSE THEN 
      bStringToUpper := 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.