Vorlage:Str match

[Werkzeuge][Bearbeiten]

Dokumentation

TemplateData

Diese Vorlage filtert einen Teilstring aus einem in in Text übergebenen String mittels deines regulären Ausdrucks (Regex) heraus.

⧼templatedata-doc-params⧽

⧼templatedata-doc-param-name⧽		⧼templatedata-doc-param-desc⧽	⧼templatedata-doc-param-type⧽	⧼templatedata-doc-param-status⧽
Text	1	Zeichenkette, Eingabetext ⧼templatedata-doc-param-example⧽ Autobahn	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-required⧽
Regex	2	Der reguläre Ausdruck. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter LUA-Zeichenketten (deutsche Zusammenfassung) und Patterns, erweitert unter die Ustring_patterns beschriebenen Unicode-Eigenschaften. Die wichtigste Einschränkung ist, dass Lua-Regexe keine Oder-Angaben (|-Sprachelement) unterstützen. ⧼templatedata-doc-param-example⧽ %u%l+	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-required⧽
Gruppen	3	Wenn mittels Klammerung mehrere Gruppen definiert wurden, kann die zurückzugebende Gruppe angegeben werden. ⧼templatedata-doc-param-default⧽ 0 (alle Teilstrings) ⧼templatedata-doc-param-example⧽ 2	⧼templatedata-doc-param-type-number⧽	⧼templatedata-doc-param-status-optional⧽

<templatedata>{"description":"Diese Vorlage filtert einen Teilstring aus einem in in Text übergebenen String mittels deines regulären Ausdrucks (Regex) heraus.","paramOrder":["1","2","3"],

"params":{ "1":{"type":"string","description":"Zeichenkette, Eingabetext","label":"Text","example":"Autobahn","required":true},

"2":{"type":"string","description":"Der reguläre Ausdruck. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter LUA-Zeichenketten (deutsche Zusammenfassung) und Patterns, erweitert unter die Ustring_patterns beschriebenen Unicode-Eigenschaften. Die wichtigste Einschränkung ist, dass Lua-Regexe keine Oder-Angaben (|-Sprachelement) unterstützen.","label":"Regex","example":"%u%l+","required":true},

"3":{"type":"number","description":"Wenn mittels Klammerung mehrere Gruppen definiert wurden, kann die zurückzugebende Gruppe angegeben werden.","label":"Gruppen","example":"2","required":false,"default":"0 (alle Teilstrings)"} }

}</templatedata>

Kopiervorlagen

<syntaxhighlight lang="wikitext" copy>

</syntaxhighlight> Falls Gleichheitszeichen (=) in den Zeichenketten vorkommen: <syntaxhighlight lang="wikitext" copy>

</syntaxhighlight>

Beispiele

Eingabe	Ausgabe	Erklärung
{{Str match|eine Zeichenkette als Test|%u%l+}}	Zeichenkette	erstes Wort, das mit einem Großbuchstaben beginnt
{{Str match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}}	русский	erste Zeichenfolge in Kyrillisch (vgl. Unicodeblock Kyrillisch)
{{Str match|Beispieltext|(Bei).+(text)|2}}	text	zweite Gruppe zurückgeben
{{Str match|Beispieltext|(Bei).+(text)|0}}	Beitext	alle Gruppen zurückgeben
{{Str match|Beispieltext|spiel}}	spiel	Teilstring ist im Text enthalten
{{Str match|Beispieltext|abcde}}		Teilstring ist im Text nicht enthalten

Siehe auch

Extraktion	Positionsbasiert {{Str left}} – gibt die ersten n Zeichen zurück {{Str right}} – gibt die Zeichen ausgenommen der ersten n zurück {{Str rightc}} – gibt die letzten n Zeichen zurück {{Str crop}} – gibt die Zeichen ausgenommen der letzten n zurück {{Str index}} – gibt das Zeichen an einer gegebenen Position zurück {{Str sub}} – gibt n Zeichen ab einer gegebenen Position zurück Musterbasiert {{Str match}} – gibt eine Teilzeichenkette basierend auf einem RegExp zurück
Länge	{{Str len}} – gibt die Länge der Zeichenkette zurück {{Str ≥ len}} – überprüft ob die Zeichenkette die angegebene Mindestlänge hat
Suche	{{Str find}} – gibt die Position des Gesuchten in einer Zeichenkette zurück
Bearbeiten	{{Str replace}} – ersetzt Teile einer Zeichenkette {{Str trim}} – entfernt führende und abschließende Leerzeichen

Modul:Str – Basismodul der meisten Vorlagen

Lua

Datei:Lua-logo-nolabel.svg

Diese Vorlage wurde ganz oder teilweise mit Hilfe der Programmiersprache Lua erstellt.

Die Module sind mit #invoke eingebunden. In der Dokumentation der einzelnen Module finden sich auch weitere Hinweise zu Rückfragen.

Verwendetes Modul: Str

Werkzeuge

Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.

• Verwendungen dieser Vorlage
• Cirrus-Suche zu Einbindungen dieser Vorlage (zunächst nur ANR) mit weiteren Möglichkeiten
• Anzahl der Einbindungen
• Liste der Unterseiten.
• Diese Dokumentation befindet sich auf einer eingebundenen Unterseite [Bearbeiten].
• Test-/Beispielseite erstellen.