Wikipedia:Lua/Modul/FormatNum/de
Vorlagenprogrammierung | Diskussionen | Lua | Test | Unterseiten | |||
Modul | Deutsch | English
|
Modul: | Dokumentation |
FormatNum
– zum Runden und Formatieren von Zahlen. Es stehen verschiedene Rundungs- und Formatierungsvarianten zur Verfügung.
Funktionen für Vorlagen
[Quelltext bearbeiten]format
[Quelltext bearbeiten]Diese Funktion formatiert eine Zahl entsprechend dem angegebenen Format. Zur Eingabe sind alle Zahlen geeignet, die als Dezimaltrennzeichen den Punkt verwenden, keine Tausendertrennzeichen haben und nicht in Exponentialschreibweise vorliegen sowie nur ASCII-Zeichen enthalten. Siehe #Zahlenformate.
Parameter
- 1
- Bisher unformatierte (aber ggf. gerundete) Gleitkomma- oder Ganzzahl.
- Pflichtparameter.
- 2
- Eines der zur Verfügung stehenden Zahlenformate. Momentan sind das
at
,ch
,ch_currency
,comma
,de
,dewiki
,de_currency
,en
,iso31_0
,iso31_0_point
. Außerdem kann mitNOSEP
die Formatierung unterbunden werden.pc
sollte mit Bedacht eingesetzt werden. - Optional, Rückfallwert:
dewiki
.
Rückgabewert
- Formatierte Zahl. Sollte ein ungültiges Argument für 2 angegeben werden oder es sich bei 1 nicht um eine gültige Zahl handeln, so wird 1 unverändert zurückgegeben.
minus
[Quelltext bearbeiten]Ein vorhandenes Unicode-Minuszeichen U+2212 = 872210 wird durch einen ASCII-Bindestrich U+002D ersetzt; oder umgekehrt.
Parameter
- 1
- Zahl.
- Pflichtparameter.
- 2
- Umwandlung in U+002D .
- Optional; Vorgabe:
0
= →ASCII (boolesch)
Rückgabewert
- Zahl mit ASCII-Bindestrich statt Minuszeichen; oder umgekehrt.
padding
[Quelltext bearbeiten]Links- oder rechtsbündiges Auffüllen mit nicht-kopierbarem Weißraum. Die Zahl wird links oder rechts bis zum Dezimaltrennzeichen so aufgefüllt, dass alle Zahlen untereinander das Dezimaltrennzeichen an der gleichen Position haben, falls die Ausdehnung des Weißraums geeignet gewählt wurde.
Parameter
- 1
- Zahl.
- Pflichtparameter.
- 2
- Ausdehnung des Weißraums. Zahlen größer Null geben die erwarteten Nachkommastellen an. Sind weniger signifikante Stellen vorhanden, wird rechts mit entsprechend breitem Weißraum aufgefüllt. Bei einer Ausdehnung kleiner Null werden Zahlen, die weniger Zeichen vor dem Dezimaltrennzeichen haben, links mit Weißraum aufgefüllt; die Angabe muss also betragsmäßig zur größten erwarteten Zahl passen.
- Pflichtparameter.
- 3
- Dezimaltrennzeichen.
- Pflichtparameter.
Rückgabewert
- Ggf. adjustierte Zahl.
roman2number
[Quelltext bearbeiten]Römische Zahl in numerische Ganzzahl wandeln.
Parameter
- 1
- Römische Zahl.
- Pflichtparameter.
- 2
- Lua-pattern für erlaubten Suffix.
- Typischerweise etwas wie
%.$
– fordert einen Ordinalpunkt nach der römischen Zahl; oder%.?$
(optional).
Rückgabewert
- Positive Ganzzahl, wenn erfolgreich.
- leer, wenn nicht interpretierbar.
round
[Quelltext bearbeiten]Diese Funktion wird zum Runden von Zahlen verwendet. Die Ausgabe ist eine Zeichenkette mit der entsprechenden Anzahl signifikanter Stellen. Zur Eingabe sind alle Zahlen geeignet, die sich mit der Lua-Methode tonumber()
parsen lassen.
Parameter
- 1
- Zu rundende Gleitkomma- oder Ganzzahl. Die Zahl muss im PC-lesbaren Format (Punkt als Dezimaltrennzeichen, keine Tausendertrennzeichen, ASCII-Minuszeichen) angegeben sein, so dass sie mittels
tonumber()
umwandelbar ist. - Pflichtparameter.
- 2
- Ganze Zahl (wird mittels
tonumber()
umgewandelt), die die Anzahl signifikanter Stellen angibt. Ist diese Zahl nicht-negativ, so handelt es sich um die Nachkommastellen. Sollte diese Zahl negativ sein, so wird der ganzzahlige Anteil der Zahl ebenfalls gerundet (-1
entspricht Rundung auf volle Zehner,-2
auf volle Hunderter, …). - Pflichtparameter.
- method
- Zahl, welche die zu verwendende Rundungsmethode beschreibt.
0
– Rundung nach IEEE 754 (round half to even).1
– Kaufmännisches Runden inklusive Eliminierung von "-0"-Ergebnissen.
- Optional; Vorgabe:
0
- format
- Formatierung mittels
format
integriert auslösen. - Der Wert ist die Formatierungsmethode.
- Die Zuweisung eines leeren Werts verwendet die Standardmethode (
dewiki
). - padding
- Formatierung mittels
format
undpadding
integriert auslösen. - Der Wert ist die Ausdehnung des Weißraums. Die Formatierungsmethode ist die Standardmethode, falls nicht mit
format=
spezifiziert. Das Dezimaltrennzeichen ergibt sich aus der Formatierungsmethode. - Optional
Rückgabewert
- Zeichenkette der entsprechend der Rundungsmethode auf die vorgegebene Anzahl signifikanter Stellen gerundeten Zahl (zunächst PC-kompatible Schreibweise ohne Formatierung). Diese kann mit der Funktion
format
weiter formatiert werden, oder das durch die Parameterformat=
bzw.padding=
ausgelöst werden. - Sollte sich eines der übergebenen Argumente nicht parsen lassen, so wird der String des Arguments 1 unverändert zurückgegeben.
- War der Eingabewert eine Gleitkommazahl (mit Dezimalpunkt), so ist das Ergebnis eine Gleitkommazahl mit Dezimalpunkt, war die Eingabe eine ganze Zahl, dann soll das Ergebnis auch eine ganze Zahl sein. Trägt die Anzahl signifikanter Stellen ein Minuszeichen (einschließlich
-0
), so ist das Ergebnis immer eine ganze Zahl.
failsafe
[Quelltext bearbeiten]Diese Funktion gibt die Versionsbezeichnung des Moduls aus.
Die Failsafe-Schnittstelle erlaubt den damit ausgerüsteten Modulen in globaler Verteilung
- sicherzustellen, dass eine von einer Vorlage oder einem Modul benötigte Funktion in der lokalen Kopie eines Bibliotheksmoduls vorhanden ist, und ggf. auch in einer erforderlichen Mindestversion;
- die globale Aktualisierung und Verknüpfung von Modulen über Wikidata zu verwalten.
Die Failsafe-Schnittstelle liegt sowohl auf Ebene der Vorlagen wie auch in direktem Lua-Zugriff vor.
Die Funktionen sind im Einzelnen (nicht alle werden bereits überall in vollem Umfang unterstützt):
Wert | Ergebnis | aktuell |
---|---|---|
nichtsfalse
|
lokale Version | »2020-08-06« |
Mindestversion | Mindestversionsbezeichnung Datum im ISO-Format Es wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.
|
|
wikidata
|
Versionsbezeichnung der globalen Mutter
|
»2020-08-06« |
~
|
Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung
|
»« |
@
|
Ist die aktuelle (Modul-)Seite richtig mit Wikidata verknüpft?
|
|
Der Rückgabewert ist in der Vorlagenprogrammierung leer und per Lua false ; andernfalls die angegebene Zeichenkette.
|
Zahlenformate
[Quelltext bearbeiten]Format/ Stichwort |
Dezimal- | Zifferngruppierung mit Tausender- | Beispiele | |||
---|---|---|---|---|---|---|
-trennzeichen | -trennzeichen | ab Länge | nur Ganzzahlteil | |||
dewiki (oder leer) |
Komma , |
Punkt . |
4 | nein | 1.234,56 1.234,567 12.345,678 1.234,567.8 12.345,567.8 123.456,78 |
-1.234,56 -1.234,567 -12.345,678 -1.234,567.8 -12.345,567.8 -123.456,78 |
de
|
Komma , |
Schmales nicht umbr. Leerzeichen |
4 | nein | 1 234,56 1 234,567 12 345,678 1 234,567 8 12 345,567 8 123 456,78 |
-1 234,56 -1 234,567 -12 345,678 -1 234,567 8 -12 345,567 8 -123 456,78 |
at
| ||||||
iso31_0
| ||||||
de_currency
|
Komma , |
Punkt . |
4 | ja | 1.234,56 1.234,567 12.345,678 1.234,5678 12.345,5678 123.456,78 |
-1.234,56 -1.234,567 -12.345,678 -1.234,5678 -12.345,5678 -123.456,78 |
ch
|
Komma , |
gerades Hochkomma ' |
5 | ja | 1234,56 1234,567 12'345,678 1234,5678 12'345,5678 123'456,78 |
-1234,56 -1234,567 -12'345,678 -1234,5678 -12'345,5678 -123'456,78 |
ch_currency
|
Punkt . |
gerades Hochkomma ' |
5 | ja | 1234.56 1234.567 12'345.678 1234.5678 12'345.5678 123'456.78 |
-1234.56 -1234.567 -12'345.678 -1234.5678 -12'345.5678 -123'456.78 |
iso31_0_point
|
Punkt . |
Schmales nicht umbr. Leerzeichen |
4 | nein | 1 234.56 1 234.567 12 345.678 1 234.567 8 12 345.567 8 123 456.78 |
-1 234.56 -1 234.567 -12 345.678 -1 234.567 8 -12 345.567 8 -123 456.78 |
en
|
Punkt . |
Komma , |
4 | ja | 1,234.56 1,234.567 12,345.678 1,234.5678 12,345.5678 123,456.78 |
-1,234.56 -1,234.567 -12,345.678 -1,234.5678 -12,345.5678 -123,456.78 |
NOSEP oder pc
|
Punkt . |
(kein Wert) | (kein Wert) | (kein Wert) | 1234.56 1234.567 12345.678 1234.5678 12345.5678 123456.78 |
-1234.56 -1234.567 -12345.678 -1234.5678 -12345.5678 -123456.78 |
comma
|
Komma , |
(leer) | 1000 | ja | 1234,56 1234,567 12345,678 1234,5678 12345,5678 123456,78 |
-1234,56 -1234,567 -12345,678 -1234,5678 -12345,5678 -123456,78 |
Funktionen für Lua-Module
[Quelltext bearbeiten]Einbindung über require()
:
local lucky, FormatNum = pcall( require, "Module:FormatNum" )
if type( FormatNum ) == "table" then
FormatNum = FormatNum.FormatNum()
else
-- Fehlerfall; FormatNum enthält Fehlermeldung
return "<span class=\"error\">" .. FormatNum .. "</span>"
end
- FormatNum.format(source, spec, meet)
-
- source: string
- spec: optional string
- meet: optional number (Ausdehnung für internes padding)
- FormatNum.minus(source, larger)
-
- source: string
- larger: optional boolean (Umwandlung in Unicode)
- FormatNum.padding(source, meet, stop)
-
- source: string
- meet: number
- stop: string
- FormatNum.roman2number(source, suffix)
-
- source: string
- suffix: optional string
- FormatNum.round(source, precision, method)
-
- source: string
- precision: number
- method: optional number
- FormatNum.format(assert)
-
- assert: optional string
- FormatNum.failsafe(atleast)
-
- atleast: optional string; Minimalversion oder
wikidata
- atleast: optional string; Minimalversion oder
- Returns string or false.
- FormatNum()
- Liefert table mit dem Zugriff auf die Funktionen (siehe oben).
Interna
[Quelltext bearbeiten]ROUND_TO_EVEN
[Quelltext bearbeiten]Interne Konstante für Rundung nach IEEE 754 (0).
ROUND_AWAY_FROM_ZERO
[Quelltext bearbeiten]Interne Konstante für kaufmännische Rundung (1).
FORMAT_TABLE
[Quelltext bearbeiten]Diese interne Tabelle enthält die Formatierungsoptionen entsprechend obiger Aufstellung. Für jede Formatierung existieren die Einträge decimalMark
(Dezimaltrennzeichen), groupMark
(Tausendertrennzeichen), groupMinLength
(Länge des Ganzzahlanteils, ab dem das Tausendertrennzeichen zur Anwendung kommt) und groupOnlyIntegerPart
(ob nur der Ganzzahlanteil gruppiert wird).
Die Tabelle für die Formatierung pc
sollte nicht definiert sein (dadurch wird ein Abbruch erreicht und die Zahl direkt unverändert zurückgegeben).
DIGIT_GROUPING_SIZE
[Quelltext bearbeiten]Interne Konstante, die die Anzahl der Ziffern pro Gruppe angibt (3).
DEFAULT_FORMAT
[Quelltext bearbeiten]Interne Konstante, die die Standardformatierungsmethode für diese Installation festlegt (dewiki).
DEFAULT_METHOD
[Quelltext bearbeiten]Interne Konstante, die die Standardrundungsmethode für diese Installation festlegt ([[#ROUND_TO_EVEN|]]).
SPACER_SPAN
[Quelltext bearbeiten]Interne Konstante, die einen schmalen Weißraum in ASCII und HTML produziert.
THIN_SPACE
[Quelltext bearbeiten]Interne Konstante, die einen nicht-umbrechenden schmalen Weißraum darstellt, und auf die zurückgefallen wird, falls [[#SPACER_SPAN|]] undefiniert ist.
PADDING_SPAN
[Quelltext bearbeiten]Interne Konstante, die für die padding-Methoden einen nichtkopierbaren Weißraum in ASCII und HTML produziert.
internal NumberToString()
[Quelltext bearbeiten]Von round
intern aufgerufene Funktion zur Rundung. Beim Aufruf sind sämtliche Parameter bereits im numerischen Format.
internal FormatNumber()
[Quelltext bearbeiten]Von format
intern aufgerufenen Funktion zur Formatierung. Die zu formatierende Zahl ist hier bereits auf Gültigkeit geprüft und ohne Vorzeichen (wird hinterher rekonstruiert). Statt einer allgemeinen Formatierungsoption werden hier die der Formatierung entsprechenden Einzelwerte aus FORMAT_TABLE übergeben.
Entwicklung
[Quelltext bearbeiten]Dies war das erste produktiv eingesetzte Modul in der deutschsprachigen Wikipedia. In der Pionierphase war vieles im Umgang mit Lua noch unklar gewesen. Inzwischen sind die Erkenntnisse gewachsen, und eine Restrukturierung wurde erforderlich.
- Die Basisfunktionen werden jetzt auch als Bibliothek direkt für andere Lua-Module verfügbar gemacht.
- Die Basisfunktionen blieben unverändert.
- Parameterwerte erhielten Default-Werte und kürzere Namen; auch für die beiden Funktionen.
Mehr kosmetischer Natur:
- Der Präfix internal ist nicht mehr erforderlich.
- Durch das
local
in der Definition wird das bereits zum Ausdruck gebracht. Globale Namen, die in Konflikt treten, gibt es nicht oder würde es langfristig nicht mehr geben; falls doch noch, würde dieseslocal
sie zuverlässig überdecken.
- Durch das
- Die zwingend erforderlichen Werte als erste Parameter wurden zu unbenannten Parametern.
- Alle angegebenen Parameter von #invoke führen zu Zeichenketten; „String“ braucht nicht erwähnt zu werden. Vorlagenprogrammierer können sowieso nichts anderes unternehmen.
- Bei einzeiligen oder kurzen Kommentaren wurden die potentiell mehrzeiligen Kommentarblöcke reduziert.
Verwendung
[Quelltext bearbeiten]Allgemein in beliebigen Vorlagen direkt nutzbar.
- Vorlage:FormatNum
- Vorlage:FormatZahl
- Unterstützung für Kategorie:Vorlage:Zahlenformatierung
Abhängigkeiten
[Quelltext bearbeiten]Keine.