Vorlage:Str index/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Str index.

TemplateData

Die Vorlage entfernt Leerzeichen am Anfang und am Ende der in Text angegebenen Zeichenkette und gibt das durch Index adressierte Zeichen aus Text zurück. Ist der Wert für Index kleiner 1, wird eine leere Zeichenkette zurückgegeben. Falls der Wert für Index größer als Text lang ist, wird ein Leerstring ausgegeben.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Text	1	Zeichenkette, aus der das Zeichen extrahiert werden soll Beispiel Autobahn	Mehrzeiliger Text	erforderlich
Index	2	Nummer des Zeichens ohne Berücksichtigung führender Leerzeichen, welches von Text ausgegeben werden sollen. Standard 0 Beispiel 4	Zahlenwert	optional

Kopiervorlagen

{{Str index| | }}

Falls Gleichheitszeichen (=) in den Parameterinhalten vorkommen:

{{Str index|1=|2=}}

Beispiele

Code	Ergebnis	Info
"{{Str index|Autobahn|2}}"	"u"
"{{Str index| Autobahn|2}}"	"u"	mit führenden Leerzeichen
"{{Str index|Autobahn|5}}"	"b"	Der fünfte Buchstabe ist ein b
"{{Str index|Autobahn}}"	""	Der fehlende zweite Parameter (Index) bedeutet Standardwert 0 und ergibt den leeren String.
"{{Str index|Autobahn|10}}"	""	Der zweite Parameter (Index) ist größer als die Zeichenkettenlänge und ergibt den leeren String.
"{{Str index|Auto bahn|8}}"	"s"	HTML-Entities werden nicht interpretiert. Wird das Semikolon extrahiert, kann es u. U. als Wikicode geparst werden.
"{{Str index|東京都| 3}}"	"都"	Leerzeichen beim 2. Parameter haben keine Wirkung
"{{Str index|東京都|-3}}"	""	Ein Index kleiner Null wird wie Null behandelt und ergibt den leeren String.
"{{Str index|東京都 |4}}"	""	Das abschließende Leerzeichen wird nicht berücksichtigt, wodurch der Text nur drei Zeichen hat.
"{{Str index| |2}}"	""	Der Text (Parameter 1) besteht nur aus 3 Leerzeichen (hier wegen HTML-Interpretation nur als eines sichtbar) und damit wird er als leerer String behandelt.
"{{Str index|a b|2}}"	" "	Der Text (drei Zeichen) enthält in der Mitte ein Leerzeichen, welches korrekt zurückgegeben wird.

Siehe auch

• Hilfe:Variablen
• Hilfe:Vorlagenprogrammierung

Vorlagen zur Zeichenkettenverarbeitung

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