Eine freie Initiative von Menschen bei ![]() ![]() ![]() ![]() mit online Lesekreisen, Übungsgruppen, Vorträgen ... |
![]() |
Use Google Translate for a raw translation of our pages into more than 100 languages. Please note that some mistranslations can occur due to machine translation. |
Modul:Str/Doku: Unterschied zwischen den Versionen
imported>Odyssee (Die Seite wurde neu angelegt: „Dieses Modul dient der Implementierung der Stringfunktionen in andere Vorlagen. == Exportierte Funktionen == === len === Gibt die Länge eines Strings zurüc…“) |
imported>Odyssee (→match) |
||
Zeile 121: | Zeile 121: | ||
=== match === | === match === | ||
Filtert einen Teilstring aus einem übergebenen String mittels eines [[regulärer Ausdruck|regulären Ausdrucks]] (Regex) heraus. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Patterns], erweitert unter die in [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Ustring_patterns] beschriebenen [[Liste der Unicode-Eigenschaften|Unicode-Eigenschaften]]. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (<tt>|</tt>-Sprachelement) unterstützen. | Filtert einen Teilstring aus einem übergebenen String mittels eines [[Wikipedia:regulärer Ausdruck|regulären Ausdrucks]] (Regex) heraus. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Patterns], erweitert unter die in [//www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual#Ustring_patterns] beschriebenen [[Wikipedia:Liste der Unicode-Eigenschaften|Unicode-Eigenschaften]]. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (<tt>|</tt>-Sprachelement) unterstützen. | ||
==== Parameter ==== | ==== Parameter ==== | ||
Zeile 144: | Zeile 144: | ||
| <tt><nowiki>{{#invoke:Str|match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}}</nowiki></tt> | | <tt><nowiki>{{#invoke:Str|match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}}</nowiki></tt> | ||
| {{#invoke:Str|match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}} | | {{#invoke:Str|match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}} | ||
| erste Zeichenfolge aus dem [[Unicodeblock Kyrillisch]] | | erste Zeichenfolge aus dem [[Wikipedia:Unicodeblock Kyrillisch|Unicodeblock Kyrillisch]] | ||
|- | |- | ||
| <tt><nowiki>{{#invoke:Str|match|Beispieltext|(Bei).+(text)|2}}</nowiki></tt> | | <tt><nowiki>{{#invoke:Str|match|Beispieltext|(Bei).+(text)|2}}</nowiki></tt> |
Aktuelle Version vom 29. Juli 2015, 17:35 Uhr
Dieses Modul dient der Implementierung der Stringfunktionen in andere Vorlagen.
Exportierte Funktionen
len
Gibt die Länge eines Strings zurück
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: der String.
Rückgabewert
Die Länge des Strings.
left
- Gibt die ersten N Zeichen eines Strings wieder.
- Hier wird die Restlänge als Argument übergeben.
- Eine Funktion mit der Anzahl der abzutrennenden Zeichen als Argument ist unter
crop
zu finden.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Anzahl der restlichen Zeichen
Rückgabewert
Entsprechend gekürzter String.
crop
- Kürzt einen String rechts um eine bestimmte Anzahl Zeichen.
- Hier wird die Länge des abzutrennenden Teilstrings als Argument übergeben.
- Eine Funktion mit der Anzahl der übrigbleibenden Zeichen als Argument ist unter
left
zu finden.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Anzahl der abzutrennenden Zeichen
Rückgabewert
Der gekürzte String.
right
Gibt die letzten n Zeichen eines Strings wieder. Diese Funktion entspricht nicht der Vorlage:Str_right. Siehe dazu auch Funktion cropleft
.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Anzahl der restlichen Zeichen
Rückgabewert
Entsprechend gekürzter String.
cropleft
- Kürzt einen String links um eine bestimmte Anzahl Zeichen.
- Hier wird die Länge des abzutrennenden Teilstrings als Argument übergeben.
- Eine Funktion mit der Anzahl der übrigbleibenden Zeichen als Argument ist unter
right
zu finden. - Diese Funktion entspricht im Wesentlichen der Vorlage:Str_right.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Anzahl der abzutrennenden Zeichen
Rückgabewert
Entsprechend gekürzter String.
index
Gibt das Zeichen an einer bestimmten Position im String wieder.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Position des Zeichens
Rückgabewert
Das Zeichen an der gegebenen Position.
sub
- Gibt einen Teil eines Strings wieder.
- Das ist die allgemeine Teilstringfunktion
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
- 2: Position des ersten Zeichens des Teilstrings.
- 3: Länge des Teilstrings.
Rückgabewert
Entsprechender Teilstring.
hex2dez
Wandelt eine als String übergebene Hexadezimalzahl in eine Dezimalzahl um. Im Fehlerfall wird Null zurückgegeben.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der String.
Rückgabewert
Die Zahl
match
Filtert einen Teilstring aus einem übergebenen String mittels eines regulären Ausdrucks (Regex) heraus. Die unterstützten Sprachelemente des regulären Ausdrucks finden sich unter [1], erweitert unter die in [2] beschriebenen Unicode-Eigenschaften. Die wichtigste Einschränkung ist das Lua-Regexe keine Alternativen (|-Sprachelement) unterstützen.
Parameter
- frame: Frame, der die Argumente der Invoke-Funktion bereithält.
Argumente
- 1: Der Eingabestring.
- 2: Der anzuwendende reguläre Ausdruck.
- 3 (optional): wenn mittels Klammerung mehrere Gruppen definiert wurden, kann die zurückzugebende Gruppe hier angegeben werden. Falls nicht angegeben, wird 0 (= alle Teilstrings) angenommen.
Rückgabewert
Ein gemäß dem angegebenen Regex gefilterter Teilstring.
Beispiele:
Eingabe | Ausgabe | Erklärung |
---|---|---|
{{#invoke:Str|match|eine Zeichenkette als Test|%u%l+}} | Zeichenkette | erstes Wort, das mit einem Großbuchstaben beginnt |
{{#invoke:Str|match|Russische Sprache (русский язык)|[Ѐ-ӿ]+}} | русский | erste Zeichenfolge aus dem Unicodeblock Kyrillisch |
{{#invoke:Str|match|Beispieltext|(Bei).+(text)|2}} | text | zweite Gruppe zurückgeben |
{{#invoke:Str|match|Beispieltext|(Bei).+(text)|0}} | Beitext | alle Gruppen zurückgeben |
Dieser Artikel basiert auf einer für AnthroWiki adaptierten Fassung des Artikels Modul:Str/Doku aus der freien Enzyklopädie de.wikipedia.org und steht unter der Lizenz Creative Commons Attribution/Share Alike. In Wikipedia ist eine Liste der Autoren verfügbar. |