Zum Inhalt springen

Vorlage:Str mid/Doku

Aus Wikivoyage

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]