Vorlage:Str find

[Werkzeuge][Bearbeiten]

Dokumentation

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.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Text	1	Zeichenkette, in der die Position von Suchtext bestimmt werden soll Beispiel Autobahn	Mehrzeiliger Text	erforderlich
Suchtext	2	Zeichenkette, die in Text gesucht werden soll. Beispiel ba	Mehrzeiliger Text	erforderlich

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.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Text	1	Zeichenkette, in der die Position von Suchtext bestimmt werden soll Beispiel Autobahn	Mehrzeiliger Text	erforderlich
Suchtext	2	Zeichenkette, die in Text gesucht werden soll. Beispiel ba	Mehrzeiliger Text	erforderlich

 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

{{str find| | }}

Falls Gleichheitszeichen in den Parameterinhalten vorkommen oder in Suchtext führende und abschließende Leerzeichen entfernt werden sollen, müssen benannte Parameter benutzt werden.

{{str find
 |1=
 |2=
}}

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

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

Lua

Diese Vorlage wurde ganz oder teilweise mit Hilfe der Programmiersprache Lua erstellt.

Die Module sind mit #invoke eingebunden. In der Dokumentation der einzelnen Module finden sich auch weitere Hinweise zu Rückfragen.

Verwendetes Modul: Str

Werkzeuge

Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.

• Verwendungen dieser Vorlage
• Cirrus-Suche zu Einbindungen dieser Vorlage (zunächst nur ANR) mit weiteren Möglichkeiten
• Anzahl der Einbindungen
• Liste der Unterseiten.
• Diese Dokumentation befindet sich auf einer eingebundenen Unterseite [Bearbeiten].
• Test-/Beispielseite erstellen.
• Die Programmierung ist gegen Bearbeitung geschützt ((Sichter) Dreiviertelschutz).