Numlex Dokumentation
Referenz
Problem melden

Eigene Einheiten & Konstanten

Definiere eigene Einheiten und app-weite Konstanten: Grammatik, Abhängigkeiten, Limits und Ablehnungsregeln.

Zwei Einstellungen erweitern, was ein Blatt sagen kann: Settings → Units definiert neue Einheiten aus vorhandenen (oder als unabhängige neue Atome), und Settings → Constants definiert bis zu 100 benannte Werte, die jedes Blatt nutzen kann.

Diese Seite dokumentiert beide Systeme: Namensregeln, Definitionsausdrücke, Abhängigkeitsauflösung und Zyklen, den app-weiten Geltungsbereich (beide werden nicht in .nlx-Exporte geschrieben) und die genauen Werte, die jedes System akzeptiert oder ablehnt.

Eigene Einheiten (Settings → Units)

Benennung

  • 1–6 ASCII-Wörter, höchstens 40 Zeichen; das erste Wort beginnt mit einem Buchstaben.
  • Der Name muss eindeutig sein: Eine Kollision mit dem Katalog oder einer anderen eigenen Einheit wird abgelehnt.
  • Die Pluralform des Namens wird automatisch akzeptiert, genau wie bei Katalogatomen.

Definitionen

Zwei Arten von Definition werden akzeptiert:

  • <number> <existing unit expression> — zum Beispiel 2.54 cm — definiert die neue Einheit über vorhandene;
  • das Literal new unit, das ein neues unabhängiges Atom deklariert.

Abhängigkeiten und Limits

  • Abhängigkeiten lösen in Deklarationsreihenfolge und außerhalb davon — die Reihenfolge spielt keine Rolle.
  • Ein Zyklus ist ein Fehler.
  • Das globale Limit sind 100 eigene Einheiten.
  • Eigene Einheiten sind app-weit (Anwendungseinstellungen) und werden nicht in einem .nlx-Blatt gespeichert.
  • In einem Blatt verhalten sich eigene Einheiten wie Katalogeinheiten: Mengen, Umrechnung und Arithmetik funktionieren wie unter Einheiten & Mengen beschrieben.

Konstanten (Settings → Constants)

Benennung

  • 1–6 ASCII-Wörter, höchstens 40 Zeichen; das erste Wort beginnt mit einem Buchstaben.
  • Es gibt reservierte Kategorien: Systemnamen und -kategorien können nicht überschrieben werden.

Ausdrücke

  • Der Ausdruck wird wörtlich als Quelltext gespeichert, höchstens 256 Zeichen.
  • Das Ergebnis muss ein endlicher dimensionsloser Skalar, ein Prozentwert oder ein Geldwert mit einem einzigen Fiat-Code sein.
  • Eine Konstante darf andere Konstanten referenzieren.

Abhängigkeiten und Limits

  • Abhängigkeiten sind unabhängig von der Deklarationsreihenfolge: Werte werden bei jeder Änderung in den Einstellungen neu berechnet, sodass eine Änderung sofort alle Blätter aktualisiert.
  • Eine zyklische Abhängigkeit ist ein Fehler.
  • Das Limit sind 100 Konstanten.
  • Konstanten sind app-weit und werden nicht in .nlx gespeichert.
  • Innerhalb eines Blatts sind Konstanten unveränderlich — sie lassen sich nur in den Einstellungen bearbeiten.

Beispiele

Mit PI, Tax und Rent, deklariert unter Settings → Constants:

PI × 2              → 6.283185307179586
Tax × 100           → 8           (Tax = 8% = 0.08; in multiplication the
                                   percent scalar returns as an ordinary number)
Rent × 12           → 14400 USD   (Rent = 1200 USD)

Abgelehnte Werte

Eine Konstantenzeile, die zu einem dieser Werte auflöst, bleibt inaktiv:

  • ein Wert mit Einheiten (9.81 m/s²),
  • Boolesche Werte,
  • Datumsangaben,
  • Zuweisungen,
  • Antwort-Token-Marker,
  • gemischte Währungen,
  • unbekannte Namen,
  • Zyklen.

Blattnamen gegenüber Konstanten

Benannte Werte in einem Blatt sind ein separates Konzept von den Einstellungs-Konstanten (siehe Blattsprache). Ein ganzzahliger benannter Wert behält seine exakte Form:

x = 0x1F
x & 1               → 1
x as hex            → 0x1F

und x wird von der Zeile x + 1 nicht verändert.

Verwandt

Einen Fehler in dieser Dokumentation gefunden? Auf GitHub melden