StrLen (Modulbaustein)

["StrLen","$In", "$Out", "$enableUTF8Count"]

Die Länge der Eingangszeichenkette "$In" wird ermittelt und in $Out das ganze Zahl bereitgestellt wird.

• "$In" Zeichenkette, deren Länge bestimmt werden soll. Die Variable muss so angelegt werden, dass sie die komplette Zeichenkette aufnehmen kann, andernfalls wird nur die Länge der abgeschnittenen Zeichenkette ermittelt.

• "$enableUTF8Count" Boolscher Eingang, optional Vorgabe true

  • true Die Anzahl der Zeichen wird zurückgegeben

  • false Die Anzahl der Bytes die die Zeichen belegen wird zurückgegeben

• $Out Anzahl der Zeichen Ganzzahl (4 Byte Integer, vorzeichenbehaftet)

• Bei $enableUTF8Count auf false wird die Länge in Bytes ausgegeben, welche die Zeichenkette zur Speicherung benötigt. Nur die ersten 128 Unicodezeichen werden bei UTF8 wie 7-Bit-ASCII gespeichert und benötigen nur ein Byte pro Zeichen. Alle anderen Zeichen wie die Umlaute benötigen zwei oder mehr Bytes um ein Zeichen abzubilden

• Bei $enableUTF8Count auf true wird 0 in $Out zurückgegeben, wenn eine UFT8 Sequenz aus mehreren Bytes nicht vollständig ist. Zusätzlich wird eine Warnung in Logik Editor im Protokoll “Warnungen und Fehler“ eingetragen.

• Vorabprüfung ob empfangene Daten korrekt sein können

• Prüfen ob Text in Display oder Visualisierung dargestellt werden kann

Erfolgreiche Wandlungen

• Zeichenkette “test” wird unabhängig von der Eingang

  $enableUTF8Count umgewandelt in den Zahlenwert 4

• Zeichenkette “100” wird unabhängig von der Einstellung

  $enableUTF8Count umgewandelt in den Zahlenwert 3

• Zeichenkette “täuschen” wird umgewandelt

  • In den Zahlenwert 9 bei $enableUTF8Count false

  • In den Zahlenwert 8 bei $enableUTF8Count true

• Zeichenkette mit Emoticon 💡 wird

  • In den Zahlenwert 4 bei $enableUTF8Count false

  • In den Zahlenwert 1 bei $enableUTF8Count true