Vorlage:Str find/Doku

TemplateData

Die Vorlage gibt die Position des ersten Zeichens von Suchtext innerhalb von Text zurück, wobei führende und abschließender Leerzeichen nicht berücksichtigt werden. Positionswerte größer 0 zeigen an, dass die Zeichenkette gefunden wurde. Kommt Suchtext nicht in Text vor, wird -1 zurückgegeben. Die Suche ist case-sensitive, das heißt, die Strings "Text" und "text" sind verschiedene Zeichenketten.

⧼templatedata-doc-params⧽

⧼templatedata-doc-param-name⧽		⧼templatedata-doc-param-desc⧽	⧼templatedata-doc-param-type⧽	⧼templatedata-doc-param-status⧽
Text	1	Zeichenkette, in der die Position von Suchtext bestimmt werden soll ⧼templatedata-doc-param-example⧽ Autobahn	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-required⧽
Suchtext	2	Zeichenkette, die in Text gesucht werden soll. ⧼templatedata-doc-param-example⧽ ba	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-required⧽

Datei:Pictogram voting info.svg Info: Um zwei Strings ohne Berücksichtigung von Groß- und Kleinschreibung vergleichen zu können, stehen die Parserfunktionen {{lc:}} und {{uc:}} zur Verfügung.

Kopiervorlage

<syntaxhighlight lang="wikitext" copy>-1</syntaxhighlight>

Falls Gleichheitszeichen in den Parameterinhalten vorkommen oder in Suchtext führende und abschließende Leerzeichen entfernt werden sollen, müssen benannte Parameter benutzt werden. <syntaxhighlight lang="wikitext" copy>1</syntaxhighlight>

Beispiele

Code	Ergebnis	Info
{{Str find|2=a}}	-1	Text weggelassen
{{Str find||a}}	-1	Text ist leere Zeichenkette
{{Str find| |a}}	-1	Text besteht nur aus 3 Leerzeichen
{{Str find| ab c | }}	3	Text mit je einem führenden und abschließenden Leerzeichen, Suchtext ist ein Leerzeichen
{{Str find| ab c |2= }}	1
{{Str find| abc|a}}	1	Text mit einem führenden Leerzeichen
{{Str find| abc| a}}	-1	Text und Suchtext mit einem führenden Leerzeichen
{{Str find| abc|2= a}}	1
{{Str find| abc|abcde}}	-1
{{Str find|ab cd | c}}	3	Suchtext mit einem Leerzeichen
{{Str find|ab cd |2= c}}	4
{{Str find|abc|b}}	2
{{Str find|abc|x}}	-1
{{Str find |AbCd| bC }}	-1	Suchtext mit je einem führenden und abschließenden Leerzeichen
{{Str find |AbCd|2= bC }}	2
{{Str find |AbCd|bC}}	2
{{Str find |AbCd|Bc}}	-1	mit Berücksichtigung von Groß- und Kleinschreibung
{{Str find |{{uc:AbCd}}|{{uc:Bc}}}}	2	ohne Berücksichtigung von Groß- und Kleinschreibung

Fehlerhafte Ergebnisse werden geliefert bei

Code	Ergebnis	Info
{{Str find}}	1	Text und Suchtext weggelassen
{{Str find||}}	1	Text und Suchtext leere Zeichenkette
{{Str find|abc}}	1	Suchtext weggelassen
{{Str find|abc|}}	1	Suchtext ist leere Zeichenkette

Siehe auch

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