enhancement
major
minor
major
minor
minor
#29670
TL-Script: Funktionen trim, trimStart und trimEnd entfernen Leerraum am Anfang und Ende einer Zeichenkette
Problem
TL-Script verfügt über keine Funktion, die führende und nachgestellte Leerzeichen aus einer Zeichenkette entfernt. Die einzige integrierte Funktion, die Leerzeichen entfernt, ist die Option „trim“ von „split(...)“, die auf die Teile einer Aufteilung angewendet wird. Ein Skript, das Benutzereingaben normalisiert – z. B. den Suchbegriff eines Suchfelds in der App-Leiste, der mit einem abschließenden Leerzeichen übermittelt wird –, muss diesen als regulären Ausdruck formulieren:
term -> regex('^\\s+|\\s+$').regexReplace($term.toString(), '')
Das ist schwer lesbar und man kann dabei leicht Fehler machen. Dies ist in der TL-Development-App erforderlich, wo „Cursor“ 10 Tickets anstelle der 15 von „Cursor“ fand und ein Feld mit Leerzeichen nach Leerzeichen suchte.
Erwartet
Eine String-Funktion `trim(string) ` / `$s.trim()`, die den String ohne führende und abschließende Leerzeichen (Unicode-Leerzeichen, wie bei `String.strip()`) zurückgibt und bei null den Wert null. Optional `trimStart ` / `trimEnd`.
Lösung
Drei neue TL-Script-Funktionen:
- trim(string) / $s.trim() – entfernt Leerzeichen am Anfang und am Ende,
- trimStart(string) / $s.trimStart() – entfernt Leerzeichen nur am Anfang,
- trimEnd(string) / $s.trimEnd() – entfernt Leerzeichen nur am Ende.
Als Leerzeichen gilt jedes Unicode-White-Space-Zeichen (wie bei ` String.strip()`). Innere Leerzeichen bleiben erhalten. Bei `null` liefern die Funktionen `null`, andere Werte werden wie bei ` toLowerCase()` zunächst in eine Zeichenkette umgewandelt.
term -> $term.trim()
Technisch
Eine GenericMethod „Trim“ (Paket com.top_logic.model.search.expr.config.operations.string) mit konfigurierbarer Seite (BOTH, START, END), registriert als drei <method>-Einträge in modelSearchConf.config.xml. Hilfeseiten unter Developer Guide → TL-Script → Strings → StringFunctions.
Test
- test.com.top_logic.model.search.expr.TestSearchExpression