Isom.Base.Number

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Base.Number

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Base.Number

Beschreibung

Isom.Base.Number speichert Zahlen als 64-bittige Gleitkommawerte (doppelte Genauigkeit), entsprechend der Norm IEC 60559:1989 (IEEE 754). Dies entspricht dem Typ System.Double der .NET-Laufzeitumgebung.

Der mögliche Wertebereich ist ±1.0E±308 mit 15 Stellen Genauigkeit.



Funktionen

Isom.Base.Number.Add

Addiert eine zweite Zahl zu dieser Zahl.

objectbound Isom.Base.Number Isom.Base.Number.Add  ( Isom.Base.Number  other  ) 

Addiert eine zweite Zahl zu dieser Zahl.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert, außer es ist ungültig

 Number a = 1; 
 a.Add(1);                    // a ist 2 
Parameter:
other  Summand, der addiert werden soll.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Summand das Void-Objekt ist.
Isom.Base.Number.AddGlobal

Speichert eine Kopie dieses Zahlenobjekts als globale Variable.

Isom.Base.Boolean Isom.Base.Number.AddGlobal  ( Isom.Base.String  key,
Isom.Base.Number  value  )

Speichert eine Kopie dieses Zahlenobjekts als globale Variable.

Die übergebene Zeichenkette ist der Schlüssel, mit dem die gespeicherte Variable danach mit .GetGlobal() abgerufen werden kann. Existiert bereits eine globale Variable mit dem Schlüssel, wird der vorher gesicherte Wert ersetzt.

 Number.AddGlobal("A", 1); 
Parameter:
key  Schlüssel, mit dem die Zahl als globale Variable gespeichert wird.
value  Zahl, die gespeichert wird.
Rückgabe:
'true', falls die Zahl als globale Variable gespeichert werden konnte, 'false' sonst (z.B. bei einem ungültigen Objekt für Schlüssel oder Wert).
Isom.Base.Number.And

Führt ein bitweises logisches UND mit dem Operanden aus.

objectbound Isom.Base.Number Isom.Base.Number.And  ( Isom.Base.Number  other  ) 

Führt ein bitweises logisches UND mit dem Operanden aus.

Für diese Operation werden beide Operanden in eine Ganzzahl konvertiert. Dadurch kann es zu einem Präzisionsverlust kommen. Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert.

 Number a = 1; 
 a.And(2); 
Parameter:
other  Operand des bitweisen logischen UND.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Operand das Void-Objekt ist.
Isom.Base.Number.Clone

Erzeugt eine identische Kopie dieses Objekts.

objectbound Isom.Base.Number Isom.Base.Number.Clone  (  ) 

Erzeugt eine identische Kopie dieses Objekts.

Rückgabe:
Kopie dieses Objekts.
Isom.Base.Number.Compl

Konvertiert dieses Objekt in das Einerkomplement.

objectbound Isom.Base.Number Isom.Base.Number.Compl  (  ) 

Konvertiert dieses Objekt in das Einerkomplement.

Für diese Operation wird die Zahl in eine Ganzzahl konvertiert. Dadurch kann es zu einem Präzisionsverlust kommen. Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert.

 Number a = 1; 
 a.Compl(); 
Rückgabe:
Das aktuelle Zahlenobjekt.
Isom.Base.Number.Div

Dividiert diese Zahl durch einen andere Zahl.

objectbound Isom.Base.Number Isom.Base.Number.Div  ( Isom.Base.Number  other  ) 

Dividiert diese Zahl durch einen andere Zahl.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert, außer es ist ungültig

 Number a = 4; 
 a.Div(2);                    // a ist 2 
Parameter:
other  Divisor, durch den dividiert werden soll.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Divisor das Void-Objekt ist.
Es wird das Void-Objekt zurückgegeben, falls der Divisor den Wert 0 hat.
Isom.Base.Number.Eq

Prüft diese und die übergebene Zahl auf Gleichheit.

objectbound Isom.Base.Boolean Isom.Base.Number.Eq  ( Isom.Base.Number  other  ) 

Prüft diese und die übergebene Zahl auf Gleichheit.

 Number a = 4.5; 
 Boolean b = a.Eq(4);                   // b ist false 
 Boolean c = a.Eq(4.5);                 // c ist true 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls beide Zahlen identisch sind, 'false' sonst. Wird das Void-Objekt übergeben, so liefert die Funktion 'false'.
Isom.Base.Number.Floor

Rundet die Zahl auf einen ganzzahligen Wert ab.

objectbound Isom.Base.Number Isom.Base.Number.Floor  (  ) 

Rundet die Zahl auf einen ganzzahligen Wert ab.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert.

 Number a = 4.5; 
 a.Floor();                   // a ist 4 
Rückgabe:
Das aktuelle Zahlenobjekt.
Isom.Base.Number.Ge

Es wird geprüft, ob diese Zahl größer gleich einer übergebenen Zahl ist.

objectbound Isom.Base.Boolean Isom.Base.Number.Ge  ( Isom.Base.Number  other  ) 

Es wird geprüft, ob diese Zahl größer gleich einer übergebenen Zahl ist.

 Number a = 4.5; 
 Boolean b = a.Ge(4);                 // b ist true 
 Boolean c = a.Ge(4.5);               // c ist true 
 Boolean d = a.Ge(5);                 // d ist false 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls diese Zahl größer gleich der übergebenen Zahl ist, 'false' sonst.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter das Void-Objekt ist.
Isom.Base.Number.GetExistingGlobals

Ruft eine Liste der Schlüssel aller globalen Variablen des Typs 'Number' ab

Isom.Base.StringList Isom.Base.Number.GetExistingGlobals  (  ) 

Ruft eine Liste der Schlüssel aller globalen Variablen des Typs 'Number' ab

   Number.AddGlobal("A", 1); 
   Number.AddGlobal("B", 2); 
   StringList keys = Number.GetExistingGlobals(); // enthält "A" und "B" 
Rückgabe:
Liste der Schlüssel aller globalen Variablen des Typs 'Number'
Isom.Base.Number.GetGlobal

Ruft das Zahlenobjekt ab, das unter dem übergebenen Schlüssel als globale Variable gesichert wurde.

Isom.Base.Number Isom.Base.Number.GetGlobal  ( Isom.Base.String  key  ) 

Ruft das Zahlenobjekt ab, das unter dem übergebenen Schlüssel als globale Variable gesichert wurde.

 Number value = Number.GetGlobal("A"); 
Parameter:
key  Schlüssel der gesuchten globalen Variable.
Rückgabe:
Kopie des gefundenen Variablenwerts. Änderungen an diesem Rückgabewert ändern den Wert der gesicherten globalen Variable nicht. Um Änderungen in die globale Variable zu übernehmen, muss der geänderte Wert mit .AddGlobal() wieder gesichert werden.
Ausnahmebehandlung:
Die Funktion liefert ein Void-Objekt, falls innerhalb dieser Sitzung noch keine Variable unter dem Schlüssel abgespeichert wurde oder der Schlüssel ein ungültiges Objekt ist.
Isom.Base.Number.Gt

Es wird geprüft, ob diese Zahl größer als eine übergebene Zahl ist.

objectbound Isom.Base.Boolean Isom.Base.Number.Gt  ( Isom.Base.Number  other  ) 

Es wird geprüft, ob diese Zahl größer als eine übergebene Zahl ist.

 Number a = 4.5; 
 Boolean b = a.Gt(4);                 // b ist true 
 Boolean c = a.Gt(4.5);               // c ist false 
 Boolean d = a.Gt(5);                 // d ist false 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls diese Zahl größer als die übergebene Zahl ist, 'false' sonst.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter das Void-Objekt ist.
Isom.Base.Number.IsVoid

Bestimmt, ob es sich um das Void-Objekt handelt.

objectbound Isom.Base.Boolean Isom.Base.Number.IsVoid  (  ) 

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Base.Number.Le

Es wird geprüft, ob diese Zahl kleiner gleich einer übergebenen Zahl ist.

objectbound Isom.Base.Boolean Isom.Base.Number.Le  ( Isom.Base.Number  other  ) 

Es wird geprüft, ob diese Zahl kleiner gleich einer übergebenen Zahl ist.

 Number a = 4.5; 
 Boolean b = a.Le(4);                 // b ist false 
 Boolean c = a.Le(4.5);               // c ist true 
 Boolean d = a.Le(5);                 // d ist true 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls diese Zahl kleiner gleich der übergebenen Zahl ist, 'false' sonst.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter das Void-Objekt ist.
Isom.Base.Number.Lt

Es wird geprüft, ob diese Zahl kleiner als eine übergebene Zahl ist.

objectbound Isom.Base.Boolean Isom.Base.Number.Lt  ( Isom.Base.Number  other  ) 

Es wird geprüft, ob diese Zahl kleiner als eine übergebene Zahl ist.

 Number a = 4.5; 
 Boolean b = a.Lt(4);                 // b ist false 
 Boolean c = a.Lt(4.5);               // c ist false 
 Boolean d = a.Lt(5);                 // d ist true 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls diese Zahl kleiner als die übergebene Zahl ist, 'false' sonst.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter das Void-Objekt ist.
Isom.Base.Number.Mod

Bestimmt den Rest aus der Division dieser Zahl durch eine andere Zahl.

objectbound Isom.Base.Number Isom.Base.Number.Mod  ( Isom.Base.Number  other  ) 

Bestimmt den Rest aus der Division dieser Zahl durch eine andere Zahl.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert, außer es ist ungültig

 Number a = 4; 
 a.Mod(2);                    // a ist 0 
Parameter:
other  Divisor für die Modulodivision.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Divisor das Void-Objekt ist.
Es wird das Void-Objekt zurückgegeben, falls der Divisor den Wert 0 hat.
Isom.Base.Number.Mul

Multipliziert diese Zahl mit einem anderen Zahl.

objectbound Isom.Base.Number Isom.Base.Number.Mul  ( Isom.Base.Number  other  ) 

Multipliziert diese Zahl mit einem anderen Zahl.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert, außer es ist ungültig

 Number a = 2; 
 a.Mul(3);                    // a ist 6 
Parameter:
other  Faktor, mit dem multipliziert werden soll.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Faktor das Void-Objekt ist.
Isom.Base.Number.Ne

Prüft diese und die übergebene Zahl auf Ungleichheit.

objectbound Isom.Base.Boolean Isom.Base.Number.Ne  ( Isom.Base.Number  other  ) 

Prüft diese und die übergebene Zahl auf Ungleichheit.

 Number a = 4.5; 
 Boolean b = a.Ne(4);                   // b ist true 
 Boolean c = a.Ne(4.5);                 // c ist false 
Parameter:
other  Zahl, mit der diese Zahl verglichen wird.
Rückgabe:
'true', falls beide Zahlen unterschiedlich sind, 'false' sonst. Wird das Void-Objekt übergeben, so liefert die Funktion 'true'.
Isom.Base.Number.Or

Führt ein bitweises logisches ODER mit dem Operanden aus.

objectbound Isom.Base.Number Isom.Base.Number.Or  ( Isom.Base.Number  other  ) 

Führt ein bitweises logisches ODER mit dem Operanden aus.

Für diese Operation werden beide Operanden in eine Ganzzahl konvertiert. Dadurch kann es zu einem Präzisionsverlust kommen. Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert.

 Number a = 1; 
 a.Or(2); 
Parameter:
other  Operand des bitweisen logischen ODER.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Operand das Void-Objekt ist.
Isom.Base.Number.RemoveGlobal

Entfernt eine globale Zahlenvariable, die unter dem übergebenen Schlüssel gespeichert wurde.

Isom.Base.Boolean Isom.Base.Number.RemoveGlobal  ( Isom.Base.String  key  ) 

Entfernt eine globale Zahlenvariable, die unter dem übergebenen Schlüssel gespeichert wurde.

Parameter:
key  Schlüssel, unter dem die globale Variable abgelegt wurde
Rückgabe:
'true', falls die globale Variable mit dem Schlüssel gelöscht wurde 'false, falls unter dem Schlüssel keine globale Variable abgelegt war.
Isom.Base.Number.Sub

Subtrahiert eine zweite Zahl von dieser Zahl.

objectbound Isom.Base.Number Isom.Base.Number.Sub  ( Isom.Base.Number  other  ) 

Subtrahiert eine zweite Zahl von dieser Zahl.

Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert, außer es ist ungültig

 Number a = 1; 
 a.Sub(1);                    // a ist 0 
Parameter:
other  Subtrahend der Operation.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Subtrahend das Void-Objekt ist.
Isom.Base.Number.ToFloatString

Gibt eine Zeichenkette mit der Gleitkommadarstellung dieser Zahl zurück.

objectbound Isom.Base.String Isom.Base.Number.ToFloatString  (  ) 

Gibt eine Zeichenkette mit der Gleitkommadarstellung dieser Zahl zurück.

 Number a = 4.4; 
 System.Stdout(a.ToFloatString());        // gibt 4.4 aus 
Rückgabe:
Zeichenkette mit der Gleitkommadarstellung dieser Zahl.
Isom.Base.Number.ToHexString

Konvertiert die Zahl in eine Ganzzahl und gibt eine Zeichenkette mit der hexadezimalen Repräsentation zurück.

objectbound Isom.Base.String Isom.Base.Number.ToHexString  (  ) 

Konvertiert die Zahl in eine Ganzzahl und gibt eine Zeichenkette mit der hexadezimalen Repräsentation zurück.

Diese umfasst kein einleitendes '0x'. Die Funktion liefert nur richtige Ergebnisse für Ganzzahlen im Bereich -2.147.483.648 bis 2.147.483.647. Für Werte außerhalb dieses Bereichs ist der Inhalt der zurückgelieferten Zeichenkette undefiniert.

 Number a = 14; 
 System.Stdout(a.ToHexString());        // gibt E aus 
Rückgabe:
Zeichenkette mit der hexadezimalen Repräsentation dieser Zahl.
Isom.Base.Number.ToIntString

Konvertiert die Zahl in eine Ganzzahl und gibt eine Zeichenkette mit der dezimalen Repräsentation zurück.

objectbound Isom.Base.String Isom.Base.Number.ToIntString  (  ) 

Konvertiert die Zahl in eine Ganzzahl und gibt eine Zeichenkette mit der dezimalen Repräsentation zurück.

Ist der Wert der Zahl größer als 9.223.372.036.854.775.807 oder kleiner als -9.223.372.036.854.775.808 so wird die Zahl als Gleitkommazahl mit Exponenten in der Zeichenkette zurückgegeben.

 Number a = 4.5; 
 System.Stdout(a.ToIntString());        // gibt 4 aus 
Rückgabe:
Zeichenkette mit der dezimalen Repräsentation dieser Zahl.
Isom.Base.Number.Void

Erzeugt ein ungültiges Objekt.

Isom.Base.Number Isom.Base.Number.Void  (  ) 

Erzeugt ein ungültiges Objekt.

Das erzeugte Void-Objekt kann z. B. in Funktionen zurückgegeben werden, um einen Fehler anzuzeigen.

Rückgabe:
Void-Objekt
Isom.Base.Number.Xor

Führt ein bitweises logisches exklusives ODER mit dem Operanden aus.

objectbound Isom.Base.Number Isom.Base.Number.Xor  ( Isom.Base.Number  other  ) 

Führt ein bitweises logisches exklusives ODER mit dem Operanden aus.

Für diese Operation werden beide Operanden in eine Ganzzahl konvertiert. Dadurch kann es zu einem Präzisionsverlust kommen. Das aktuelle Zahlenobjekt übernimmt das Ergebnis als neuen Wert.

 Number a = 1; 
 a.Xor(2); 
Parameter:
other  Operand des bitweisen logischen XODER.
Rückgabe:
Das aktuelle Zahlenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Operand das Void-Objekt ist.

Version 9.10.1.0 vom 25 November 2013