Integer

Serialisieren

Serialisierung des Objekts und der Daten. In dem serialisierten Objekt werden auch Meta-Informationen zum Abgleich gespeichert. Soll eine abgeleitete Klasse nicht serialisierbar sein, so muss diese Methode überschrieben werden und eine Exception werfen.

Eigenschaften die mit volatile oder associated beginnen werden gesonder behandelt. Eigenschaften mit Prefix volatile werde nicht serialisiert. Bei Eigenschaften mit der Vorsilbe associated wird nur die ID des Objektes serialisiert. Wird in der Eigenschaft kein Objekt gespeichert wird eine TypeException geworfen.

Prüfen ob das Objekt associative Eigenschaften besitzt

Prüfen ob das Objekt volatile Eigenschaften besitzt

Umgang mit Versionen

Diese Methode überprüft ein Objekt und repariert im idealfall ältere Kopien. Kann eine alte Kopie nicht wieder hergestellt werden, so wird eine Exeption geworfen.

Diese Methode muss von den abgeleiteten Klassen überschrieben werden. In der abgeleiteten Klasse sollte die Parent-Methode aufgerufen werden.

Diese Methode wird in der Folge durch \unserialize aufgerufen und initialisert das neue Objekt. Diese Methode sollte so nicht selber aufgerufen werden.

Gespeicherte Zahl als Zeichenkette zurückgeben.

Wird beim Setzen einer Eigenschaft aufgerufen. Wird auf die Eigenschaft Integer zugegriffen, so wird diese im Integerobjekt verarbeitet, ansonsten im Alvine-Objekt als Eigenschaft.

Wird aufgerufen, wenn isset() auf ein internes Property angewendet wird.

Zurücksetzen von Werten

Je nach Name wird entweder der Integer-Wert der Klasse, oder der Wert einer beliebigen Eigenschaft zurückgegeben.

Closure über den definierten Namen holen. Ist keine Eigenschaft mit dem Namen definiert, so wird eine BadPropertyException geworfen. Gibt es eine Eigenchaft mit dem Namen, ist diese aber kein Closure, so wird eine NotFoundException geworfen.

Prüfen ob eine Eigenschaft als dynamische Eigenschaft verfügbar ist, die über $obj->property abgefragt werden kann.

if($obj->propertyExists('myproperty')) {
  $value = $obj->myproperty;
}

Ein Closures das dem Objekt übergeben wurde, kann entweder als Property oder als Funktion aufgerufen werden.

Achtung: Wird das Closure in einem Objekt definiert, so ist die Variable $this nicht das Objekt des Closures, sondern des, in dem das Closure definiert wurde.

// als erster Parameter wird immer das Objekt übergeben
$a->myfunction = function($obj, $b) { echo $b.'!'; };
// Aufruf als Eigenschaft ohne Parameter
$a->myfunction;  // Ausgabe ist ein !
//
// Aufruf als Methode mit Parametern
$a->myfunction('OK');  // Ausgabe ist  OK!

Mit dieser Methode kann geprüft werden, ob eine Methode aufrufbar ist. Das gilt für echte und eingehängte DI-Methoden (Lambda).

if($obj->isCallable('myfunction')) {
  $obj->myfunction();
}

Die Methode Alvine::getID() verwenden!

Diese Methode gibt eine eindeutige ID des Objektes zurück. Bei der ID handelt es sich um eine Zeichenkette in der Form einer UUID.

Objekte haben bei der Erstellung noch keine eindeutige ID, erst mit dem expliziten Aufruf der ID wird diese einmalig erstellt und im Objekt gepseichert.

Diese Methode wird implizit beim Serialisieren aufgerufen.

Die UUID ist dabei vom Type4 (Random)

Diese Methode entfernt alle Minuszeichen aus der UUID des Hash. Wird eine Länge definiert, so wird nach dem entfernen der Minuszeichen die ersten $length Zeichen zurückgegeben.

Diese Methode ist hilreich um Platz zu sparen.

Je kürzer die ID ist, um so größer ist die Wahrscheinlichkeit einer Kollision.

Vergleich der Objekte

Diese Methode gibt ein geklontes Objekt von sich selber zurück.

Wenn eine abgeleitete Klasse diese Methode nicht unterstützt, so muss diese die Methode überschreiben und eine CloneNotSupportedException werfen. Die Standardmethode klont eine seichte Kopie der Eigenschaften. Das bedeutet das Objekte in den Eigenschaften nicht geclont werden. Sollen diese auch geclont werden muss true übergeben werden.

Wenn weitere Funktionen implementiert werden sollen, so muss __clone überschrieben werden

Interne Hook für das Clonen des Objektes. Wenn das zu klonende Objekt bereits eine eindeutige ID hat, dann wird auch für das neue Objekt eine eindeutige ID erstellt.

Alvine-Objekte werden rekursive geclont, so das ein vollständiger Clone vorhanden ist.

Name der Klasse

class MyObject extends Alvine {};
$obj = new MyObject();

echo $obj->getClass();

Prüft ob das übergebene Objekt eine Instanz dieses Objektes ist. Allerdings ist darauf zu achten, das vorher definiert wurde, das das neue Objekt von Alvine abgeleitet wurde.

if($obj instanceof Alvine &&
   $obj->isInstanceOf($object)) { };

Die Prüfung entspricht

$this instanceof $object

Neue Ganzzahl anlegen.

Diese interne Methode prüft den übergebenen Wert und wandelt diesen bei Bedarf in einen Integer um. Sollte es sich bei dem Wert um keinen gültigen Wert handeln, so wird eine Null "0" zurück gegeben.

$i = '14a'; // ist 0 und nicht 14!

Gibt den auf dem System größten Integerwert zurück.

Gibt den auf dem System kleinsten Integerwert zurück.

Setzt der Wert des Integers, wenn der übergebene Wert größer als der gespeicherte Wert ist.

$obj = new Integer(4);
$obj.max(3);   // Der Wert von $obj ist immer noch 4
$obj.max(6);   // Der Wert von $obj ist jetzt 6

Setzt der Wert des Integers, wenn der übergebene Wert kleiner als der gespeicherte Wert ist.

$obj = new Integer(4);
$obj.min(6);   // Der Wert von $obj ist immer noch 4
$obj.min(3);   // Der Wert von $obj ist jetzt 3

Addiert eine neue Zahl zu dem Integer hinzu und gibt ein neues Objekt zurück.

Subtrahiert eine Zahl von dem Integer und gibt ein neues Objekt zurück.

Wertebereich überprüfen. Ist ein Wert außerhalb des Wertebereichs, so wird der Wert auf die Grenze, die er überschritten hat gesetzt.

Wichtig: Wird ein Objekt übergeben, so wird der Wert des übergebenen Objektes gesetzt.

$i = 98;
echo Integer::validateRange($i,0,50); // 50
$integer = new Integer(12);
echo Integer::validateRange($integer,20,50)->integer; // 20
echo $integer->integer; // 20

Gerichteter Vergleich von $this mit $x

Gibt 0 zurück, wenn das Objekt und der Parameter identisch sind. 1 wenn das Objekt größer ist und -1, wenn das Objekt kleiner ist.

Es sollte folgendes gelten (x.compareTo(y)==0) == (x.equals(y))