EBSILON®Professional Online Dokumentation
EbsScript / EbsScript Interface Units / InterfaceUnit-Units (Maßeinheiten)
In diesem Thema
    InterfaceUnit-Units (Maßeinheiten)
    In diesem Thema

    InterfaceUnit - Units
     

    Name

    Zweck

    Argumente

    Rückgabe-
    wert

    Beispiel

    unitsConvert

    rechnet einen mit einer Einheit behafteten Wert in eine andere Einheit um

    1: REAL: Zahlenwert in der ursprünglichen Einheit

    2: UNIT_Enum: ursprüngliche Einheit

    3: REAL: berechneter Zahlenwert in der gewünschten Einheit

    4: UNIT_Enum: gewünschte Einheit

    UnitsErrorEnum: Fehlerstatus

    uses @units;

    var

    r, rSource, rDest:REAL;

    u, uSource, uDest:UNIT_Enum;

    str,strSource, strDest:string;

    d:DIM_Enum;

    v:variant;

    begin

    rSource:=7200;

    uSource:=UNIT_kg_h;

    uDest:=UNIT_t_h;

    if (unitsConvert(rSource, uSource, rDest, uDest) = UnitsErrorOK) then

    begin

    strSource:=unitsGetTextFromUnit(uSource);

    strDest:=unitsGetTextFromUnit(uDest);

    println (rSource," ",strSource," are ",rDest," ",strDest);

    end;

     

    d:=unitsGetDim(Sun.DNI);

    u:=unitsGetDefaultUnit(d);

    str:=unitsGetTextFromUnit(u);

    println (str);

     

    d:=unitsGetDimFromUnit(UNIT_kg_h);

    u:=unitsGetDefaultUnit(d);

    str:=unitsGetTextFromUnit(u);

    println (str);

     

    u:=unitsGetUnitFromText("mbar");

    str:=unitsGetTextFromUnit(u);

    println (str);

     

    if (unitsGetValueWithUnit(SUN.DNI, v, UNIT_W_m2, false)=UnitsErrorOK) then

    begin

    str:=unitsGetTextFromUnit(u);

    println (v.rval);

    end;

    u:=unitsGetVisibleUnit(SUN.DNI, false);

    str:=unitsGetTextFromUnit(u);

    println (str);

     

    if (unitsSetValueWithUnit(50.0, UNIT_mbar, Start_value_2.P)=UnitsErrorOK) then

    begin

    println (Start_value_2.P);

    end;

    if (unitsSetVisibleUnit(Start_value_2.P, UNIT_mbar)=UnitsErrorOK) then

    begin

    u:=unitsGetVisibleUnit(Start_value_2.P, false);

    str:=unitsGetTextFromUnit(u);

    println (str);

    u:=unitsGetVisibleUnit(Start_value_2.P, true);

    str:=unitsGetTextFromUnit(u);

    println (str);

    end;

     

    end.

    unitsFromSI


    rechnet Wert von Ebsilon-Standard-Einheit in gegebeneEinheit um

    1: REAL: Zahlenwert in  der Ebsilon-Standard-Einheit

    2: UNIT_Enum: gewünschte Einheit

    3: REAL: return on error value (default value is -1000)

    REAL: errechneter Wert in der gewünschten Einheit

    unitsGetDefaultUnit

    liefert die Standard-Einheit zu einer Größe (Dimension)

    1: DIM_Enum: gegebene Dimension

    2: UnitSystemEnum: Einheitensystem, das zugrunde gelegt werden soll. Dieser Parameter ist optional. Falls er fehlt, wird die Ebsilon-Standardeinstellung UnitsSystemSI zugrundegelegt

    UNIT_Enum: gesuchte Einheit

    unitsGetDim

    liefert die Dimension einer Ebsilon-Variable

    1: ebsVar: zu betrachtende Ebsilon-Variable

    DIM_Enum: gesuchte Dimension

    unitsGetDimFromUnit

    liefert die Dimension zu einer gegebenen Einheit

    1: UNIT_Enum: gegebene Einheit

    DIM_Enum: gesuchte Dimension

    unitsGetTextFromUnit

    liefert den Klartext (als String) zu einer Einheit

    1: UNIT_Enum:  gegebene Einheit

    STRING: Klartext zur Einheit

    unitsGetUnitFromText

    liefert zu einem gegebenen Klartext die Einheit

    1: STRING: gegebener Klartext zur Einheit

    UNIT_Enum: gesuchte Einheit

    unitsGetValueWithUnit

    liefert zu einer Ebsilon-Variable den Zahlenwert einschließlich der Einheit

    1: ebsVar: zu betrachtende Ebsilon-Variable

    2: variant: gesuchter Wert

    3: UNIT_Enum: Einheit des gesuchten Wertes

    4: BOOLEAN: entscheidet bei Ebsilon-Variablen, die Flags sind, darüber, ob der Zahlenwert oder der Text des Flags ausgegeben wird:

    true: Flags werden als Text ausgegeben

    false: Flags werden als Zahlenwert ausgegeben

    UnitsErrorEnum: Fehlerstatus

    unitsGetVisibleUnit

    liefert die Einheit zu einer Ebsilon-Variable

    1: ebsVar

    2: BOOLEAN:
    false: liefert die im Objekt hinterlegte Einheit (unabhängig von der eingestellten Darstellung)

    true: liefert die angezeigte Einheit

    UNIT_Enum: gesuchte Einheit

    unitsSetValueWithUnit

    setzt eine Ebsilon-Variable auf einen bestimmten Wert einschließlich der Einheit

    1: REAL: zu verwendender Wert

    2: UNIT_Enum: zu verwendende Einheit

    3: ebsVar: Ebsilon-Variable, die gesetzt werden soll

    UnitsErrorEnum: Fehlerstatus

    unitsSetVisibleUnit

    ändert die beim Bauteil hinterlegte Einheit

    1: ebsVar: Ebsilon-Variable, deren Einheit geändert  werden soll

    2: UNIT_Enum: zu verwendende Einheit

    UnitsErrorEnum: Fehlerstatus

    unitsToSI

    rechnet Wert von gegebener Einheit in Ebsilon-Standard-Einheit um

    1: REAL: Wert in gegebener Einheit

    2: UNIT_Enum: angegebene Einheit

    3: REAL: return on error value (default value is -1000)

    REAL: errechneter Wert in der SI-Standard-Einheit