Cowboy: Neu angelegt

2025-03-08T23:22:54Z

Neu angelegt

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage prüft, ob der übergebene Parameter numerisch ist (im Sinne der [[Hilfe:Parserfunktionen/Zahlen|Vorlagenprogrammierung]] in der englischen Zahlenschreibweise, mit Punkt als Dezimaltrenner). Falls der Eingangsparameter numerisch ist, wird der Wert <code>1</code> (für true, wahr), im anderen Fall der leere Wert zurückgegeben (und keine Fehlermeldung, welche auch immer, ausgegeben).

== Verwendung ==
Diese Vorlage soll nur in anderen Vorlagen verwendet werden, um dort sinnvoll auf fehlerhafte Parameter reagieren zu können.
<nowiki>{{</nowiki>#if: <nowiki>{{</nowiki> {{PAGENAME}}|''<expression>'' }} | ''<ist-zahl-text>'' | ''<sonst-text>'' }}
Beispiel:
<nowiki>{{#if: {{ </nowiki>{{PAGENAME}}<nowiki>|{{{1|}}} }} | {{Höhe|{{{1|}}}}} | {{{1|}}} }}</nowiki>
In diesem Beispiel wird der erste Parameter der aufrufenden Vorlage geprüft und falls es sich um eine Zahl handelt, in die [[Vorlage:Höhe]] weitergereicht, die einen numerischen Parameter erwartet, andernfalls wird der erste Parameter unverändert ausgegeben und ein Fehler vermieden. Natürlich kann die aufrufende Vorlage an dieser Stelle ihre spezifische Fehlermeldung ausgeben.

== Parameter ==

<nowiki>{{IstZahl|</nowiki>''<Zahl oder Ausdruck>''|''<Zahlraum>''|''<Rundung>''<nowiki>}}</nowiki>

* '''Erster Parameter''': Die zu testende Zahl
* '''Zweiter Parameter''' (optional): Test, ob übergebener Wert
** ''leer'' oder R: eine Reelle Zahl ist
** R+: eine nicht-negative Zahl ist
** R-: eine nicht-positive Zahl ist
** Z: eine Ganze Zahl ist
** N oder Z+: eine Natürliche Zahl ist (inkl. 0)
** Z-: eine nicht-positive Ganze Zahl ist
* '''Dritter Parameter''' (optional): Test, ob der Wert auf eine bestimmte Weise gerundet wurde (siehe Parserfunktion <code>[[Hilfe:Parserfunktionen/Zahlen#expr|#expr]]</code> unter ''round'')

== Hintergrund ==

Bisherige Implementierungen haben bei Berechnungen in Vorlagen oft den Fehlertext abgefangen, der aus nicht numerischen Werten resultiert. Dies hat aber mehrere Nachteile:
* es gibt verschiedene Fehlerfälle (etwa „Unexpected number“ oder „Unrecognised punctuation character“)
* Fehlertexte können variable Teile enthalten (etwa den fehlerhaften Dezimaltrenner)
* Fehlertexte sind in Englisch, seit neuestem auf Deutsch
* Fehlertexte sind im Prinzip nirgendwo definiert. Sie sind (vermutlich) nicht Teil der offiziellen Schnittstellen und können sich daher im Prinzip mit jeder neuen Version der MediaWiki-Software ändern.

{{Achtung|1=
Die Programmierung dieser Vorlage wird bei Gelegenheit umgestellt auf [[Hilfe:Lua|Lua]].

Die Implementierung ist schon weit fortgeschritten, jedoch noch nicht ausgetestet.

Eingebunden wird dann das [[CowboysWiki:Lua/Modul/Expr/de#pipeline|Modul:Expr]].}}
<includeonly>
[[Kategorie:Vorlage:Funktion|IstZahl]]
</includeonly>

Vorlage:IstZahl/Doku - Versionsgeschichte

Cowboy: Neu angelegt