Regex (Modulbaustein)

["Regex","$In","$Expression", "$HasMatch", "$Match", "$Group1", "$Group2", "$Group3", "$Group4", "$Group5"]

Die Eingangszeichenkette "$In" wird anhand des regulären Ausdrucks (“Regex”) in "$Expression" verarbeitet. Das Ergebnis wird in den Ausgangsleveln bereitgestellt.

• "$In" Zeichenkette auf die der reguläre Ausdruck angewendet werden soll (String)

• "$Expression" regulärer Ausdruck im PCRE2 Format (String)

• $HasMatch Wahrheitswert der aussagt, ob der reguläre Ausdruck für die übergebene Zeichenkette zu einem Ergebnis geführt hat (zu filternde Zeichenkette wurde in der Quel-Zeichenkette gefunden)

• $Match Der Teil der übergebene Zeichenkette, welcher zum Ergebnis geführt hat

• $Group1 bis $Group5 Über Gruppierungskonstrukte im regulären Ausdruck können mehrere Abschnitte der Quell-Zeichenkette parallel ausgefiltert und diese Ergebnisse von bis zu fünf separaten Gruppen über die entsprechenden Ausgänge übergeben werden.

• Es werden nur Zeichenketten mit 8 Bit pro Zeichen korrekt verarbeitet (ASCII, ANSI, UTF-8)

• Die Regulären Ausdrücke können auf https://regex101.com/ (Extern, Englisch) entwickelt und getestet werden. Der Flavor ist auf PCRE2 (PHP >=7.3) und die Function auf Match zu stellen.

• Für die korrekte Funktion des Moduls müssen die Anzahl der verarbeitbaren Zeichen (Länge der Zeichenkette) für JEDEN der beteiligten String Level auf den jeweiligen Anwendungsfall angepasst werden.
  Sollte die maximal erlaubte Länger für einen Level zu kurz gewählt worden sein, dann wird die jeweilige Zeichenkette bei der Ein- bzw. Ausgabe aus dem Modul abgeschnitten, was zu unerwarteten Ergebnissen führen kann.
  Eine hohe Anzahl von Leveln mit langen möglichen Zeichenketten führt zu einem erhöhtem Ressourcen Verbrauch im Speicher und bei der Bearbeitung, selbst wenn diese Level nicht mit Inhalt gefüllt werden.

• Werden Zahlen in Zeichenketten über diese Regex-Funktion ermittelt, dann können diese über die separaten Module STR->INT und STR->FLOAT aus der Textkodierung (Level String) in eine Zahlenkodierung (Level Integer oder Level Float) umgewandelt werden.

• XML Daten verarbeiten

• Werte aus Loxone Webservices verarbeiten

• Zeichenketten auftrennen

• Komplexe Statusrückmeldungen auf Fehler prüfen