Vorlage:Str mid/Doku

Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Str mid.
Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist.

Diese Vorlage wurde am 16. November 2013 von Template:Str mid der englischen Wikipedia importiert. Statt Änderungen hier auf Wikivoyage vorzunehmen, sollte eine neuer Import vorgezogen werden, falls im originalen Wiki neue Funktionen hinzugekommen sind. Stimme dich dazu bitte mit der Community in der Vorlagenwerkstatt ab.

Diese Vorlage benutzt Module:String, Skripte geschrieben in der Programmiersprache Lua. Bitte informiere dich dort, wenn du mehr über die Sprache und ihren Einsatz erfahren willst. Diese Vorlagen sollte im Regelfall nicht ersetzt werden.

Funktion[Bearbeiten]

Die Funktion gibt einen gewünschten Teilstring einer Zeichenkette zurück

Verwendung[Bearbeiten]

Die Zeichen in der Quellzeichenkette werden gezählt. Die Zählung startet bei 1, der letzte Index entspricht der Länge der Zeichenkette. Die Teilzeichenkette wird durch den Anfangs und Endindex oder auch durch die Länge der Teilzeichenkette definiert werden.:

{{Str mid|<Quellstring>|<index Start>|<Länge Teilzeichenkette>|<index Ende>}}

Rückgabe unter Angabe von Startposition und Länge:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

Fehlt die Startposition, wird am Anfang gestartet:

{{Str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcde

Fehlt die Länge, wird der gesamte Rest ausgegeben:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Zählung vom Ende[Bearbeiten]

Negative Angaben zählen vom Ende der Zeichenkette aus rückwärts:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
{{Str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Benutzung einer Endposition[Bearbeiten]

Anstelle der Länge der Zeichenkette kann auch eine Endposition angegeben werden:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

Leerzeichen[Bearbeiten]

Der Rückgabestring wird getrimmt:

{{Str mid|I like this.|2|6}} → >like<

Leerzeichen am Anfang und Ende der AUsgangszeichenkette werden abgeschnitten:

{{Str mid| I like this.|2|6}} → >like<

Fehlermeldungen[Bearbeiten]

Werden unmgliche oder nicht auswertbare Parameter angegeben, wird eine Fehlermeldung ausgegeben:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|30}} → String Module Error: Indexangaben für Teilzeichenkette außerhalb des Bereichs

Die Fehlermeldung kann durch Angabe von |ignore errors=true unterdrückt werden. Dann wird nur eine leer Zeichenkette ausgegeben:

{{Str mid|Abcdefghijklmnopqrstuvwxyz|30}} →

Fehlerkategorien[Bearbeiten]

|no category=true – Unterdrückt die Einsortierung in eine Fehlerkategorie.
|error category=[[Category:Your category name]] – Setzt die Bezeichnung der Fehlerkategorie im Falle von Fehlern.

Standard ist Kategorie:Fehlerberichte des Moduls String.

Siehe auch[Bearbeiten]

a d b Vorlagen zur Zeichenkettenmanipulation

Diese Funktionen benutzen ein Lua-Modul.

Trimmen nach Anzahl	{{Str mid}} – Gibt einen Teilstring unter Angabe von Position und Länge zurück. {{Trunc}} – Reduziert eine Zeichenkette auf eine Solllänge. {{Str left}} – Reduziert eine Zeichenkette auf eine Sollänge von links an gezählt oder füllt eine Zeichenkette durch Duplizierung auf eine Solllänge auf. {{Str crop}} – Schneidet eine bestimmte Anzahl von Zeichen am Ende ab. {{Chop head and tail}} – Schneidet eine bestimmte Anzahl von Zeichen am Anfang und Ende ab. {{Str right}} – Schneidet eine bestimmte Anzahl von Zeichen am Ende ab. {{Str rightc}} – Gibt die übergebene Anzahl von Zeichen vom Ende der Zeichenkette zurück. {{Str rightmost}} – Kürzt eine Zeichenkette auf die angegebene Anzahl am Ende. {{Str sub old}} – Kürzt eine Zeichenkette auf eine bestimmte Anzahl, gestartet an der angegebenen Position. {{Str sub new}} – Gibt eine Teilzeichenkette unter Angabe von Start- und Endposition zurück. {{Str index}} – Gibt den Buchstaben an einer bestimmten Position zurück.

Trimmen nach Bedingung	{{Trim}} – To trim any leading or trailing whitespace ({{Strip whitespace}} does so too, but is less effective) {{First word}} – To trim down to the first space. {{Remove first word}} – To remove anything before the first space. {{Str letter/trim}} – To trim down to the beginning letters. {{Str number/trim}} – To trim down to the beginning numbers.

Zeichen einfügen	{{Loop}} – Repeat character string n times {{Replace}} – Returns the string, after replacing all occurrences of a specified string with another string. {{Strloc insert}} – Inserts a string at character location strloc, or appends if strloc<=0. {{Strloc prefix}} – Extracts string prefix up to location strloc, or whole string if strloc<=0. {{Str rep}} – Returns the string, after replacing the first occurrence of a specified string with another string.

Längenauswertungen	{{Str len}} – Returns a string's length. {{Str ≥ len}} – To check if a string is "longer or equally long" or "shorter" than a given length. {{Str ≤ len}} – To check if a string is "shorter or equally long" or "longer" than a given length. {{Str ≠ len}} – To check if a string is "not equal" or "equal" to a given length. {{Str ≤ ≥ len}} – To check if a string is "shorter", "equal", or "longer" than a given length.

Analyse	{{Str endswith}} – To check if a string ends with a given string. {{Str find}} – Returns the numerical location of a given string in a string. {{Strfind short}} – Returns the numerical location of a given string in a string. {{Str find0}} – Zero-based substring search. {{Str sub find}} – Searches a substring in a string at the given offset. {{ASCII code}} – Returns the ASCII value of a single character. {{Str letter}} – Returns the number of letters that begin a string. {{Str number}} – Returns the number of numbers that begin a string. {{Str gtr str}} – Compares two strings for alphabetical order, and returns a value accordingly.

Spezialanwendungen	{{Title without disambig}} – To trim off any parenthesis text at the end of a string (disambiguation). {{Title disambig text}} – Returns text in parenthesis at the end of a string (disambiguation). {{Unlink}} – Removes wikilink brackets (wikicode). {{Remove file prefix}}—Removes "File:" or "Image:" from filenames.

Technisches	Module:String mw:Help:Magic words – About `{{padleft:\|}}`. mw:Help:Extension:ParserFunctions – About `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.

Kategorie:Vorlagen:Zeichenkettenmanipulation Meta-Wiki Englischsprachige Wikipedia