Wikipedia:Lua/Modul/Vorlage:Str
< Wikipedia:Lua | Modul
Vorlagenprogrammierung | Diskussionen | Lua | Test | Unterseiten | |||
---|---|---|---|---|---|---|---|
Modul | Deutsch | English
|
Modul: | Dokumentation |
Vorlage:Str
– Modul für die Vorlage:Str …… Familie, und Ausführung der gesamten Aktivitäten.
Die Zusammenstellung richtet sich nach der deutschsprachigen Wikipedia 2010.
Funktionen für Vorlagen
Wie bei der Vorlagenprogrammierung 2006–2011 werden in der Regel alle Zeichenkettenparameter getrimmt (auch wenn sie alle unbenannt sind); Ausnahmen sind benannt.
- Alle angegebenen Parameter beziehen sich wahlweise
- auf den Aufruf mit
#invoke
, falls dieser Parameter enthält; - auf die umgebende Vorlageneinbindung, falls nicht.
- auf den Aufruf mit
- crop
- Gibt Text {1} um die Anzahl {2} rechts verkürzt zurück. Wird Anzahl nicht angegeben, wird 0 angenommen.
- en:Template:Str crop
- Text
- Anzahl; 1 wenn nicht angegeben
- Fehler, wenn {2} < 0
- Rückgabewert: Verbleibende Zeichenkette am Anfang, falls überhaupt.
- find
- Suche eines Teilzeichenkette {2} in einem Text {1}.
- Text
- Teilzeichenkette
- Rückgabewert: Zeichenposition; gezählt ab 1 (nicht 0-basiert wie sonst bei Berechnungen).
-1
wenn nicht gefunden- en:Template:Str find
- hex2dez
- Gibt den ganzzahligen Wert aus Hexadezimalcode Text {1} zurück. Ist dies nicht interpretierbar, wird 0 zurückgegeben.
- Zeichenkette, mit 0-9 A-F a-f
- index
- Gibt ein einzelnes Zeichen aus dem getrimmten Text {1} zurück, das durch Index {2} festgelegt wird. Text und Index sind Pflichtangaben.
- Text
- Index, gezählt ab 1 in Text
- Fehler, wenn Index größer gewählt wird als Text lang ist
- en:Template:Str index
- left
- Gibt die ersten Anzahl{2} Zeichen von Text {1} zurück. Ist die Anzahl {2} größer als die Textlänge, wird eine leere Zeichenkette zurückgegeben.
- Text
- Anzahl; wenn nicht angegeben, wird 1 angenommen.
- en:Template:Str left
- len
- Ermittlung der Stringlänge. Führende und nachfolgende Leerzeichen bleiben unberücksichtigt.
- Zeichenkette
- en:Template:Str len
- ≥ len
- Bedingte Antwort in Abhängigkeit von der Länge einer Zeichenkette {1} im Vergleich mit einer gegebenen Länge {2}.
- Zeichenkette
- Länge
- Daten (Zeichenkette), wenn „länger als oder gleich lang“.
- Daten (Zeichenkette), wenn „kürzer als“.
- Fehler, wenn {1} undefiniert oder ungültig.
- Rückgabewert: Zeichenkette; entweder {3} oder {4}.
- en:Template:Str ≥ len – intern:
ge_len()
- match
- Gib aus Zeichenkette {1} die Zeichenkette nach Muster {2} zurück; optional Klammerausdruck {3}.
- Text (nicht getrimmt)
- Suchmuster (pattern; nicht getrimmt)
- Nummer des Klammerausdrucks in {2} (optional); Vorgabe:
0
= alles
- repeating
- Wiederhole Zeichenkette {1} insgesamt {2} Mal.
- Zeichenkette (nicht getrimmt)
- Anzahl der Wiederholungen (sinnvoll); Vorgabe sowie ungültig:
1
(identisch {1})
- replace
-
- Zeichenkette (nicht getrimmt)
- Suchmuster (pattern; nicht getrimmt)
- Ersetzungs-Zeichenkette (nicht getrimmt)
- Anzahl der Wiederholungen begrenzen (optional); Vorgabe sowie ungültig: so oft wie möglich
- Buchstäbliche Suche (keine pattern-Syntax) ausführen (optional) für
1
; Vorgabe:0
= {2} als pattern interpretieren
- right
- Zeichen rechts von Position {2} bis zum Ende der Zeichenkette {1}.
- Text
- Position
Eine negative Position wird als Null behandelt, und es wird einfach die gesamte Zeichenkette zurückgegeben.
- en:Template:Str right
- rightc
- Letzte {2} Zeichen in Text {1}.
- Anzahl der Zeichen (optional); Vorgabe sowie ungültig:
0
= alles - Text
- Anzahl der Zeichen (optional); Vorgabe sowie ungültig:
- sub
- Alias für sub0
- sub0
- Teil von Text {1} beginnend bei Position {2} und mit einer Länge {3} (maximal); Zählweise ab Null.
- Text
- Position
gezählt ab 0. - Länge
- en:Template:Str sub old
- sub1
- Teil von Text {1} beginnend bei Position {2} und mit einer Länge {3} (maximal).
- Text
- Position
gezählt ab 1. - Länge
- en:Template:Str sub new
- sub_new
- Alias für sub1
- sub_old
- Alias für sub0
Testseite
Allgemeine Hinweise zur Einbindung von Modulen
Eine Einbindung erfolgt jeweils im Format
{{#invoke: Vorlage:Str |
Funktionsname | Wert1 | Wert2 | NameX=Wert … }}
Die Parameter können wie bei Vorlagen benannt oder unbenannt sein.
Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=
Wert gearbeitet werden.
Für weitere Informationen siehe Hilfe:Lua.