LitDev 1.2.14.0 DE Extension API

LD3DView LDArray LDBits LDBlueTooth LDCall
LDChart LDClient LDClipboard LDColours LDCommPort
LDController LDControls LDCursors LDDataBase LDDateTime
LDDebug LDDialogs LDDictionary LDEffect LDEmail
LDEncryption LDEvents LDFastArray LDFastShapes LDFigures
LDFile LDFocus LDftp LDGraph LDGraphicsWindow
LDHID LDImage LDInline LDIOWarrior LDList
LDLogic LDMath LDMathX LDMatrix LDMusic
LDNetwork LDPhysics LDProcess LDQueue LDRegex
LDResources LDScrollBars LDSearch LDServer LDSettings
LDShapes LDShell LDSort LDSound LDSpeech
LDStatistics LDStopwatch LDText LDTextWindow LDTimer
LDTranslate LDUnits LDUtilities LDWaveForm LDWebCam
LDWindows LDxml LDZip

LDUnits
Allgemeines, editierbares System zur Einheitenumrechnung.
Alle Einheiten und Dimensionen unterscheiden zwischen Groß-/Kleinschreibung.
Eine Basiseinheit besteht aus unabhängiger Einzeldimension und Name.
Eine abgeleitete Einheit besteht aus Beschreibung, Name und Einheitsdefinition (aus Basis- oder abgeleiteten Einheiten), sowie optionalem Additionsterm (Standard: 0).
Eine Einheit wird geparst durch trennende . / + - und *, dann rekursive Auflösung abgeleiteter Einheitenumrechnungen, () Klammerterme zuerst.
Werte (spez. mit Dezimalpunkt '.' oder Minus '-') sollten in () eingeschlossen werden.
Einer Einheit kann eine Vorsilbe/Präfix oder Zahlenwert vorangestellt sein (zB. m für milli 0.001, k für kilo 1000 usw.).
Jeder Einheit kann eine Potenz nachgestellt sein.
Eine typische Einheit wäre "mile/hr", "m/s2", "kg.m/s2", "MJ/day" usw. jede Kombination von Basis-/abgeleiteten Einheiten. Jedes Einheitenpaar mit gleicher Dimension kann konvertiert werden.
Ein Additionswert wird nur für nicht-zusammengesetzte Einheitsumrechnung verwendet (zB. C zu F).
Zur Konflikvermeidung durch unklare Einheitsvorsilben, vollen Vorsilbename verwenden (zB. min kann 60 sec oder 0.001 inch bedeuten, letzeres sollte milliin sein).
Währungsumrechnungen werden täglich aktualisiert.

example other-samples\LDUnits.sb
http://de.wikipedia.org/wiki/Internationales_Einheitensystem


AddBaseUnit AddConstant AddDerivedUnit
Convert Export GetBaseUnits
GetConstants GetDerivedUnits GetDimensions
GetErrors GetPrefixes Import

AddBaseUnit(dimension,name)
Fügt eine Basiseinheit zum Einheitensystem hinzu.
dimension Die Dimension der Basiseinheit (zB. TEMPERATUR).
name Der Einheitenname/Formelzeichen (Achtung vor Konflikt mit existierenden Einheitennamen).

AddConstant(description,name,value)
Fügt eine dimensionslose Konstante zum Einheitensystem hinzu.
description Optionaler Langname oder Beschreibung der Konstanten.
name Der Konstantenname (Achtung vor Konflikt mit existierenden Konstantennamen).
value Der Wert der Konstante.
example http://de.wikipedia.org/wiki/Mathematische_Konstante
http://de.wikipedia.org/wiki/Physikalische_Konstante
http://en.wikipedia.org/wiki/Astronomical_constant


AddDerivedUnit(description,name,units,add)
Fügt eine abgeleitete Einheit zum Einheitensystem hinzu.
description Optionaler Langname oder Beschreibung der abgeleiteten Einheit.
name Der Einheitenname/Formelzeichen (Achtung vor Konflikt mit existierenden Einheitennamen).
units Die Definition der abgeleiteten Einheit.
add Ein optionaler Additionsterm (Standard: 0).

Convert(value,fromUnit,toUnit)
Konvertiert einen Wert von einer Einheit zu einer anderen.
value Der zu konvertierende Wert.
fromUnit Die zu konvertierende Ausgangseinheit (Formelzeichen).
toUnit Die Zieleinheit nach Konvertierung (Formelzeichen).
returns Der konvertierte Wert bei Erfolg, sonst "FAILED" (zB. nicht-existente Einheit oder unvereinbare Dimensionen).

Export()
Speichert das aktuelle Einheitensystem in eine UTF8 Textdatei ('units.txt' in Program.Directory).

GetBaseUnits()
Ermittelt alle aktuellen Basiseinheiten als Array "DIM=Basiseinheit;..;".
returns Ein Array verfügbarer Basiseinheiten, indexiert durch die Dimension der Einheit.
Arraywert ist der Name der Basiseinheit (Formelzeichen).


GetConstants()
Ermittelt alle aktuellen Konstanten als Array "pi=3.14..;e=2.718..;".
returns Ein Array verfügbarer Konstanten, mit dem Konstantenname (und Beschreibung) als Index und deren Wert als Arraywert.

GetDerivedUnits()
Ermittelt alle aktuellen abgeleiteten Einheiten als Array "Einheit=(Konst)Umrechnung (Beschreibung);..;".
returns Ein Array verfügbarer abgeleiteter Einheiten mit dem Name der Einheit als Index.
Arraywert ist die Basis-/abgeleitete Einheit (Formelzeichen), die zur Umrechnung verwendet wird (mit Beschreibung).


GetDimensions(unit)
Ermittelt für eine Einheit alle enthaltenen Dimensionen und deren Potenzen als Array.
unit Die Einheit deren Dimensionen zu ermitteln sind (Groß-/Kleinschr. beachten).
returns Ein Array mit der Dimension als Index und deren Potenz als Arraywert oder "".
example 'Dimensionen für 1 N (Newton = kg*m/sec2):
GetDimensions("N") ' "TIME=-2;LENGTH=1;MASS=1;"


GetErrors()
Ermittelt Fehlermeldungen bei 'Convert' Mißerfolg oder Konflikt mit hinzugefügten Einheiten oder Konstanten als Array.
returns Ein Array mit Fehlermeldungen oder "".

GetPrefixes()
Ermittelt alle aktuellen Präfixe (Vorsilben) als Array "..;centi=0.01;milli=0.001;..;".
returns Ein Array verfügbarer Präfixe mit der Vorsilbe als Index und deren Potenzwert als Arraywert.
example http://de.wikipedia.org/wiki/Vorsätze_für_Maßeinheiten

Import()
Lädt ein gespeichertes Einheitensystem von einer Datei ('units.txt' in Program.Directory).