Documentation

SI extends SystemOfUnits

in package

• Alvine
• Measure

Diese Klasse stellt Konstanten für Umrechnung und Symbol der SI-Einheiten zur Verfügung.

Tags

category

Framework

author

schukai GmbH [email protected]

license

http://alvine.io/license/ Licence

link

Alvine

since

20110904

Table of Contents

Constants

AMPERE  = 'A'

elektrische Stromstärke, Ampère

APIVERSION  = 1

Version der API-Version der Klasse.

CANDELA  = 'cd'

Lichtstärke Candela cd

CELSIUS  = '°C'

CENTIMETER  = 'cm'

COULOMB  = 'C'

CUBICMETER  = 'm³'

CUBICMETRE  = 'm³'

FARAD  = 'F'

GRAM  = 'gr'

HERTZ  = 'Hz'

IDENTIFICATION  = 'Alvine'

Identifizierung der Alvine API

JOULE  = 'J'

KELVIN  = 'k'

thermodynamische measureeratur

KILOGRAM  = 'Kg'

Gewicht Kilogramm

KILOMETER  = 'km'

LUMEN  = 'lm'

LUX  = 'lx'

METER  = 'm'

Meter

METERPERSECOND  = 'm/s'

METRE  = 'm'

Meter

MILLIMETER  = 'mm'

MOLE  = 'mol'

Substanzmenge mol

NEWTON  = 'N'

OHM  = 'Ω'

PASCAL  = 'P'

RADIAN  = 'rad'

SECOND  = 's'

Zeit Sekunde

SERIALVERSION  = 1

Version der Klasse (wird für die Serialisierung verwendet. Ändert sich der interne Aufbau der Klasse, so muss dieser Wert nach oben gesetzt werden. Die Serialisierung muss diesen Wert abfragen und bei Bedarf einen Wrapper für das Arbeiten mit veralteten Objekten implmenetieren.

SQUAREMETER  = 'm²'

STERADIAN  = 'sr'

VERSION  = 2

Generelle Alvine-Version

VOLT  = 'V'

WATT  = 'W'

Properties

$hasAssociatedProperties  : boolean

$hash  : string

Eindeutige ID

$hasVolatileProperties  : boolean

$instances  : array

$properties  : array

$units  : Unit

Methods

__call()  : mixed

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

__clone()  : mixed

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.

__get()  : mixed

Diese Methode wird inplizit aufgerufen wenn eine nicht definierte Eigenschaft abgefragt wird. Ist die Eigenschaft eine Anonyme-Funktion (Closure), so wird diese Funktion aufgerufen und die Klasse als Parameter übergeben.

__isset()  : boolean

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

__serialize()  : array<string|int, mixed>

Serialization of the object and data. In the serialized object also stores meta-information for matching.

__set()  : void

Jede von der Alvine-Klasse abgeleitete Klasse besitzt die Fähigkeit beliebige Werte und Lambda-Funktionen an das Objekt zu hängen.

__toString()  : string

Standardumwandlung des Inhalts der Klasse in eine Zeichenkette

__unserialize()  : void

__unset()  : mixed

Zurücksetzen von Werten

ampere()  : ElectricCurrent

Ampere

candela()  : LuminousIntensity

Lichtstärke

celsius()  : Unit

Temperatur (Celsius)

centimeter()  : Unit

Centimeter

coulomb()  : Unit

Kapazität

cubicMeter()  : Unit

Kubikmeter

equals()  : boolean

Diese Funktion vergleicht zwei Objekte. Dazu wird von beiden der Wert, der von `Alvine::getID()` zurückgeliefert wird ermittelt und das Ergebnis verglichen. Vererbte Klassen können diese Methode überschreiben.

farad()  : Unit

Farad

getClass()  : string

Name der Klasse

getClone()  : Alvine

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

getClosure()  : Closure

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.

getHashCode()  : string

Die Methode Alvine::getID() verwenden!

getID()  : string

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

getInstance()  : object

Instanz erstellen

getOrCreateUnit()  : class

Erstellen von eindeutigen Einheiten

getShortID()  : string

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.

getUnit()  : Unit|null

gram()  : Unit

Gramm

hasAssociatedProperties()  : boolean

Check if the object has associative properties

hasVolatileProperties()  : boolean

Prüfen ob das Objekt volatile Eigenschaften besitzt

hertz()  : Unit

Hertz

isCallable()  : bool

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

isInstanceOf()  : boolean

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.

joule()  : Unit

Joule

kelvin()  : Temperature

Temperatur

kilogram()  : Mass

Masse

kilometer()  : Unit

Kilometer

lumen()  : Unit

Lumen

lux()  : Unit

Lux

meter()  : Length

Länge

meterPerSecond()  : Unit

Geschwindigkeit

metre()  : Length

Alias für meter()

millimeter()  : Unit

Millimeter

mole()  : AmountOfSubstance

Stoffmenge

newton()  : Unit

Newton

ohm()  : Unit

Widerstand

pascal()  : Unit

Pascal

propertyExists()  : boolean

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

radian()  : Unit

Radian

second()  : Duration

Zeit

squareMeter()  : Unit

Quadratmeter

steradian()  : Unit

Steradian

volt()  : Unit

Spannung (Volt)

watt()  : Unit

Watt

__construct()  : mixed

Von der Singleton-Klasse kann keine Instanz direkt erstellt werden.

checkAndAdjustSerialisation()  : array<string|int, mixed>

Dealing with versions

// 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!

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

class MyObject extends Alvine {
}

$obj = new MyObject();
$obj->myValue = 4;

echo (string) new MyObect();

class MyObject extends Alvine };

$objA = new MyObject();
$objB = new MyObject();

if($objA->equals($objB)) {
  // ...
}

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

echo $obj->getClass();

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

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

$this instanceof $object

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