Vorlage:Str match/Doku

Diese Vorlage gibt einen Teil von Text zurück. Der Teil wird mit einem regulären Ausdruck (Regex) festgelegt. Die unterstützten Sprachelemente des regulären Ausdrucks sind auf mediawiki.org hier und hier nachzulesen.

Kopiervorlage

{{str match|Text|Ausdruck|Gruppe}}

Parameter

• Text: (Pflicht) Text, von dem ein Teil ausgegeben werden soll
• Ausdruck: (Pflicht) Regulärer Ausdruck (Regex)
• Gruppe: (Optional) Zurückzugebende Gruppe. Wurden (mittels Klammerung in Ausdruck) mehrere Gruppen definiert, wird hier die zurückzugebende Gruppe festgelegt. Vorgabewert ist 0, das entspricht allen Teilstrings.

Beispiele

Eingabe	Ausgabe	Erklärung
{{Str match|eine Zeichenkette als Test|%u}}	Z	erstes Zeichen, das mit einem Großbuchstaben (Uppercase) beginnt
{{Str match|eine Zeichenkette als Test|%u%l}}	Ze	erste Zeichen, die mit einem Großbuchstaben (uppercase) gefolgt von einem Kleinbuchstaben (lowercase) beginnt
{{Str match|eine Zeichenkette als Test|%u%l+}}	Zeichenkette	erstes Wort, die mit einem Großbuchstaben beginnt
{{Str match|Zeichenkette|(Zeich).+(kette)|2}}	kette	zweite Gruppe zurückgeben

Vorlagen zur Zeichenkettenverarbeitung

Vorlagen zur Zeichenkettenverarbeitung
Extraktion
	{{Str left}}	gibt die ersten n Zeichen zurück
	{{Str right}}	gibt die Zeichen rechts ab der angegebenen Position 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 der angegebenen Position n zurück
	{{Str sub}}	gibt n Zeichen ab der angegebenen Position zurück
	{{Str match}}	gibt Teilzeichenkette basierend auf einem regulären Ausdruck (Regex) zurück
Länge
	{{Str len}}	gibt Länge der Zeichenkette zurück
	{{Str ≥ len}}	überprüft Zeichenkette auf angegebene Mindestlänge
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

Lua

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

• Module sind mit #invoke eingebunden.
• Im Quelltext-Modus dieser Vorlage sieht man, welche(s) Modul(e) in dieser Vorlage eingebunden ist/sind.
• In der Dokumentation der einzelnen Module findet man ggf. weitere Hinweise.