Wikipedia:Lua/Modul/Vorlage:Str

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
  1. auf den Aufruf mit #invoke, falls dieser Parameter enthält;
  2. auf die umgebende Vorlageneinbindung, falls nicht.

crop

Gibt Text {1} um die Anzahl {2} rechts verkürzt zurück. Wird Anzahl nicht angegeben, wird 0 angenommen.

en:Template:Str crop

1. Text
2. 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}.

1. Text
2. 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.

1. 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.

1. Text
2. 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.

1. Text
2. Anzahl; wenn nicht angegeben, wird 1 angenommen.

en:Template:Str left

len

Ermittlung der Stringlänge. Führende und nachfolgende Leerzeichen bleiben unberücksichtigt.

1. 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}.

1. Zeichenkette
2. Länge
3. Daten (Zeichenkette), wenn „länger als oder gleich lang“.
4. 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}.

1. Text (nicht getrimmt)
2. Suchmuster (pattern; nicht getrimmt)
3. Nummer des Klammerausdrucks in {2} (optional); Vorgabe: 0 = alles

repeating

Wiederhole Zeichenkette {1} insgesamt {2} Mal.

1. Zeichenkette (nicht getrimmt)
2. Anzahl der Wiederholungen (sinnvoll); Vorgabe sowie ungültig: 1 (identisch {1})

replace

1. Zeichenkette (nicht getrimmt)
2. Suchmuster (pattern; nicht getrimmt)
3. Ersetzungs-Zeichenkette (nicht getrimmt)
4. Anzahl der Wiederholungen begrenzen (optional); Vorgabe sowie ungültig: so oft wie möglich
5. 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}.

1. Text
2. 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}.

1. Anzahl der Zeichen (optional); Vorgabe sowie ungültig: 0 = alles
2. Text

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.

1. Text
2. Position
   gezählt ab 0.
3. Länge

en:Template:Str sub old

sub1

Teil von Text {1} beginnend bei Position {2} und mit einer Länge {3} (maximal).

1. Text
2. Position
   gezählt ab 1.
3. Länge

en:Template:Str sub new

sub_new

Alias für sub1

sub_old

Alias für sub0

Testseite

Vorhanden.

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.