Hpl am 31. August 2006 um 07:59 Uhr

2006-08-31T07:59:57Z

← Nächstältere Version		Version vom 31. August 2006, 07:59 Uhr
Zeile 249:		Zeile 249:


			{\| style="border:1px solid #8888aa; background-color:#f7f8ff;padding:5px;font-size:95%;"
			\|
			Dieser Artikel basiert auf dem Artikel [http://de.wikipedia.org/wiki/Hilfe:Vorlagenprogrammierung Vorlagenprogrammierung] aus der freien Enzyklopädie [http://de.wikipedia.org/ Wikipedia] und steht unter der [http://example.com/fdl.txt GNU-Lizenz für freie Dokumentation]. In der Wikipedia ist eine [http://de.wikipedia.org/w/index.php?title=Hilfe:Vorlagenprogrammierung&action=history Liste der Autoren] verfügbar.
			\|}


	[[Kategorie:Hilfe:Vorlagenprogrammierung\| ]]		[[Kategorie:Hilfe:Vorlagenprogrammierung\| ]]

Hpl am 11. August 2006 um 09:54 Uhr

2006-08-11T09:54:43Z

← Nächstältere Version		Version vom 11. August 2006, 09:54 Uhr
Zeile 251:		Zeile 251:


	[[Kategorie:Hilfe:~~Vorlage mit Programmierung~~\| ]]		[[Kategorie:Hilfe:Vorlagenprogrammierung\| ]]

Hpl am 2. August 2006 um 11:00 Uhr

2006-08-02T11:00:55Z

← Nächstältere Version		Version vom 2. August 2006, 11:00 Uhr
Zeile 1:		Zeile 1:
	Seit Mitte April 2006 verfügt die [[Hilfe:~~Textgestaltung~~\|Wiki-Syntax]] der MediaWiki-Software testweise über verschiedene Konstrukte einer [[Programmiersprache]] für die Verwendung in [[Hilfe:Vorlagen\|Vorlagen]], die unter anderem die If-Konstrukte ersetzen sollen.		Seit Mitte April 2006 verfügt die [[Hilfe:Textgestalltung\|Wiki-Syntax]] der MediaWiki-Software testweise über verschiedene Konstrukte einer [[Programmiersprache]] für die Verwendung in [[Hilfe:Vorlagen\|Vorlagen]], die unter anderem die If-Konstrukte ersetzen sollen.

	Die Sprachkonstrukte sollten '''ausschließlich''' im Vorlagen-Namensraum verwendet und wohlüberlegt eingesetzt werden. Nicht jede Spielerei, die möglich ist, ist auch sinnvoll. Die genaue Syntax kann sich noch ändern! Programmierkonstrukte, die nicht ausreichend dokumentiert sind, werden wieder gelöscht.		Die Sprachkonstrukte sollten '''ausschließlich''' im Vorlagen-Namensraum verwendet und wohlüberlegt eingesetzt werden. Nicht jede Spielerei, die möglich ist, ist auch sinnvoll. Die genaue Syntax kann sich noch ändern! Programmierkonstrukte, die nicht ausreichend dokumentiert sind, werden wieder gelöscht.

Hpl am 2. August 2006 um 09:48 Uhr

2006-08-02T09:48:16Z

Neue Seite

Seit Mitte April 2006 verfügt die [[Hilfe:Textgestaltung|Wiki-Syntax]] der MediaWiki-Software testweise über verschiedene Konstrukte einer [[Programmiersprache]] für die Verwendung in [[Hilfe:Vorlagen|Vorlagen]], die unter anderem die If-Konstrukte ersetzen sollen.

Die Sprachkonstrukte sollten '''ausschließlich''' im Vorlagen-Namensraum verwendet und wohlüberlegt eingesetzt werden. Nicht jede Spielerei, die möglich ist, ist auch sinnvoll. Die genaue Syntax kann sich noch ändern! Programmierkonstrukte, die nicht ausreichend dokumentiert sind, werden wieder gelöscht.

== Beschreibung der ParserFunctions ==

=== Funktion if ===

Die <code>if</code>-Funktion ist ein Wenn-Dann-Sonst-Konstrukt. Die Syntax:

<nowiki>{{</nowiki>#if: ''<bedingung>'' | ''<dann-text>'' | ''<sonst-text>''}}

Ist ''<code><nowiki><bedingung></nowiki></code>'' leer oder besteht nur aus Leerzeichen (Whitespace), gilt es als falsch, und ''<code><nowiki><sonst-text></nowiki></code>'' wird zurückgegeben. Sonst wird ''<code><nowiki><dann-text></nowiki></code>'' zurückgegeben. ''<code><nowiki><sonst-text></nowiki></code>'' kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.

'''Achtung:''' <code>if</code> unterstützt '''keine''' Gleichungen oder Ähnliches. Siehe dafür <code>ifeq</code> und <code>ifexpr</code>.

=== Funktion ifeq ===

<code>ifeq</code> vergleicht zwei Zeichenketten und gibt je nach Ergebnis verschiedene Texte zurück.

<nowiki>{{</nowiki>#ifeq: ''<text 1>'' | ''<text 2>'' | ''<text wenn gleich>'' | ''<text wenn ungleich>'' }}

=== Funktion expr ===

<tt>expr</tt> berechnet mathematische Ausdrücke.

<nowiki>{{</nowiki> #expr: ''<ausdruck>'' }}

{| {{Prettytable}}
|+ Mögliche Operationen
|-
! Operator
! Operation
! Beispiel
|-
! *
| Multiplikation
| <nowiki>{{#expr: 30 * 7}}</nowiki> = {{#expr: 30 * 7}}
|-
! / oder div
| Division
| <nowiki>{{#expr: 30 / 7}}</nowiki> = {{#expr: 30 / 7}}
|-
! +
| Addition
| <nowiki>{{#expr: 30 + 7}}</nowiki> = {{#expr: 30 + 7}}
|-
! -
| Subtraktion (or Negation)
| <nowiki>{{#expr: 30 - 7}}</nowiki> = {{#expr: 30 - 7}}
|-
! mod
|| Modulo, der Rest einer Division
||<nowiki>{{#expr: 30 mod 7}}</nowiki> = {{#expr: 30 mod 7}}
|-
! round
| Rundet die Zahl auf der linken Seite auf die Anzahl Stellen, die von der Zahl auf der rechten Seite angegeben wird
| <nowiki>{{#expr: 30 / 7 round 7}}</nowiki> = {{#expr: 30 / 7 round 7}}
|-
! =
| Gleichheit
| <nowiki>{{#expr: 30 = 7}}</nowiki> = {{#expr: 30 = 7}}
|-
!nowrap|<> oder !=
|Ungleichheit
| <nowiki>{{#expr: 30 <> 7}}</nowiki> = {{#expr: 30 <> 7}}
|-
! <
| Kleiner als
| <nowiki>{{#expr: 30 < 7}}</nowiki> = {{#expr: 30 < 7}}
|-
! >
| Größer als
| <nowiki>{{#expr: 30 > 7}}</nowiki> = {{#expr: 30 > 7}}
|-
! <=
| Kleiner oder gleich
| <nowiki>{{#expr: 30 <= 7}}</nowiki> = {{#expr: 30 <= 7}}
|-
! >=
| Größer oder gleich
| <nowiki>{{#expr: 30 >= 7}}</nowiki> = {{#expr: 30 >= 7}}
|-
! and
| Logisches UND
| <nowiki>{{#expr: 30 and 7}}</nowiki> = {{#expr: 30 and 7}}
|-
! or
| Logisches ODER
| <nowiki>{{#expr: 30 or 7}}</nowiki> = {{#expr: 30 or 7}}
|-
! not
| Logisches NICHT
| <nowiki>{{#expr: not 7}}</nowiki> = {{#expr: not 7}}
|-
! ( )
| Gruppierung/Klammerung
| <nowiki>{{#expr: (30 + 7) * 7 }}</nowiki> = {{#expr: (30 + 7) * 7 }}
|}

Die Bool'schen Operatoren behandeln 0 (Null) als falsch und 1 als wahr. Zahlen werden mit dem Punkt als Dezimaltrenner angegeben.

Beispiel:

<nowiki>{{ #expr: (100 - 32) / 9 * 5 round 0 }}</nowiki>

ergibt:

{{ #expr: (100 - 32) / 9 * 5 round 0 }}

Damit werden 100 Fahrenheit auf die Celsius-Skala umgerechnet (auf die nächste Ganze Zahl gerundet).

Da diese Berechnungen aus Kompatibilitätsgründen mit dem englischen Zahlenformat durchgeführt werden (Beispiel: <code><nowiki>{{ #expr: 13000 / 3.1 round 2 }}</nowiki></code> ergibt {{ #expr: 13000 / 3.1 round 2 }}) müssen solche Zahlen zusätzlich in das im deutschen Sprachraum übliche Format umgewandelt werden (Beispiel: <code><nowiki>{{ </nowiki></code>[[Hilfe:Variablen|formatnum:]]<code><nowiki> {{ #expr: 13000 / 3.1 round 2 }} }}</nowiki></code> ergibt {{ formatnum: {{ #expr: 13000 / 3.1 round 2 }} }}).

=== Funktion ifexpr ===

<code>ifexpr</code> Wertet einen mathematischen Ausdruck aus.

<nowiki>{{</nowiki>#ifexpr: ''<ausdruck>'' | ''<dann-text>'' | ''<sonst-text>'' }}

Ist das Ergebnis von ''<code><nowiki><bedingung></nowiki></code>'' 0 (Null), wird ''<code><nowiki><sonst-text></nowiki></code>'' zurückgegeben. Sonst wird ''<code><nowiki><dann-text></nowiki></code>'' zurückgegeben. ''<code><nowiki><sonst-text></nowiki></code>'' kann auch weggelassen werden, dann wird in diesem Fall nichts zurückgegeben.

Die Syntax für Ausdrücke wird in der Beschreibung von <nowiki>expr</nowiki> erklärt.

=== Funktion switch ===

<code>switch</code> vergleicht einen Wert mit mehreren anderen. Die Grundsyntax ist:

<nowiki>{{</nowiki>#switch: ''<vergleichswert>''
| ''<wert1>'' = ''<ergebnis1>''
| ''<wert2>'' = ''<ergebnis2>''
| ''...''
| ''<wertn>'' = ''<ergebnisn>''
| #default = ''<standardergebnis>''
}}

<code>switch</code> geht alle Werte durch, bis der Vergleichswert gefunden wird. Dann wird das entsprechende Ergebnis (hinter dem Gleichheitszeichen) zurückgegeben. Wenn kein Wert übereinstimmt, wird der Eintrag unter <code>#default</code> verwendet, sofern es diesen gibt. (Falls das Standardergebnis kein Gleichheitszeichen enthält, kann <code>#default</code> auch weggelassen werden.)

„Durchfall“-Werte sind ebenfalls möglich:

<nowiki>{{</nowiki> #switch: ''<comparison value>''
| ''<wert1>''
| ''<wert2>''
| ''<wert3>'' = ''<ergebnis1,2,3>''
| ''...''
| ''<wertn>'' = ''<ergebnisn>''
| #default = ''<standardergebnis>''
}}

Hier für <code>''<wert1>''</code>, <code>''<wert2>''</code> und <code>''<wert3>''</code> derselbe Wert <code>''<ergebnis1,2,3>''</code> zurückgegeben.

=== Verwendung mit subst ===

Die ParserFunctions können auch mit subst verwendet werden, solange kein Leerzeichen zwischen <code>subst:</code> und <code>#</code> steht.

== Überprüfung von Zeichenketten ==

Mit ''#expr:'' können zwar numerische Werte, jedoch keine Zeichenketten verwendet werden. Dies lässt sich aber über die folgenden Vorlagen bewerkstelligen. Sie sind nicht Teil der ParserFunctions, werden allerdings der Vollständigkeit halber hier mit aufgelistet, um einen umfassenden Überblick über die zur Vorlagen-Programmierung einsetzbaren Mittel zu geben.

Nachfolgend bedeutet ''wahr'', dass der jeweilige Parameter eine nicht-leere Zeichenkette enthält sowie nicht nur aus Whitespaces besteht.

{|{{prettytable}}
! Syntax
! Beschreibung
! Wahrheitstabelle
|-
| <nowiki>{{</nowiki>[[Vorlage:booland|booland]]<nowiki>|A|B}}</nowiki>
| Wenn A '''und''' B wahr sind, ist das Ergebnis wahr.
| {{Wahrheitstabelle|X|||}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolor|boolor]]<nowiki>|A|B}}</nowiki>
| Wenn A '''oder''' B wahr sind, ist das Ergebnis wahr.
| {{Wahrheitstabelle|X|X|X|}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolxor|boolxor]]<nowiki>|A|B}}</nowiki>
| Wenn entweder A '''oder''' B wahr ist, ist das Ergebnis wahr.
| {{Wahrheitstabelle||X|X|}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolnxor|boolnxor]]<nowiki>|A|B}}</nowiki>
| Wenn A '''und''' B '''falsch''' sind oder A '''und''' B wahr sind, ist das Ergebnis falsch.
| {{Wahrheitstabelle|X|||X}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolnand|boolnand]]<nowiki>|A|B}}</nowiki>
| Wenn A '''oder''' B '''falsch''' sind, ist das Ergebnis wahr.
| {{Wahrheitstabelle||X|X|X}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolnor|boolnor]]<nowiki>|A|B}}</nowiki>
| Wenn A '''und''' B '''falsch''' sind, ist das Ergebnis wahr.
| {{Wahrheitstabelle||||X}}
|-
| <nowiki>{{</nowiki>[[Vorlage:boolnot|boolnot]]<nowiki>|A}}</nowiki>
| Wenn A falsch ist, ist das Ergebnis wahr.
|}



[[Kategorie:Hilfe:Vorlage mit Programmierung| ]]

Hilfe:Vorlagenprogrammierung - Versionsgeschichte

Hpl am 31. August 2006 um 07:59 Uhr

Hpl am 11. August 2006 um 09:54 Uhr

Hpl am 2. August 2006 um 11:00 Uhr

Hpl am 2. August 2006 um 09:48 Uhr