Collection (Objekt): Unterschied zwischen den Versionen
K (Hob den Schutz von „Collection (Objekt)“ auf) |
|||
Zeile 43: | Zeile 43: | ||
| Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist. | | Liefert <code>true</code>, wenn das Objekt in der Liste enthalten ist. | ||
| 1 | | 1 | ||
+ | |- | ||
+ | | <code>toJson()</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toJson([[Number]] intentFactor)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toJson([[Number]] intentFactor, [[Number]] intent)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toJson([[Number]] intentFactor, [[Number]] intent, [[String]] intentChar)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toPhpArray()</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toPhpArray([[Number]] intentFactor)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toPhpArray([[Number]] intentFactor, [[Number]] intent)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
+ | |- | ||
+ | | <code>toPhpArray([[Number]] intentFactor, [[Number]] intent, [[String]] intentChar)</code> | ||
+ | | [[String]] | ||
+ | | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | ||
+ | | 2.9 | ||
|} | |} | ||
Zeile 53: | Zeile 93: | ||
::;Boolean | ::;Boolean | ||
:::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>. | :::<code>true</code>, wenn das Objekt enhalten ist, sonst <code>false</code>. | ||
− | + | ;<code>[[String]] toJson([[Number]] intentFactor, [[Number]] intent, [[String]] intentChar)</code> | |
+ | :Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | ||
+ | :;Parameter | ||
+ | ::;<code>[[Number]] intentFactor</code> | ||
+ | :::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0). | ||
+ | ::;<code>[[Number]] intent</code> | ||
+ | :::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0). | ||
+ | ::;<code>[[String]] intentChar</code> | ||
+ | :::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' '). | ||
+ | :;Rückgabewert | ||
+ | ::;String | ||
+ | :::JSON als String. | ||
+ | ;<code>[[String]] toPhpArray([[Number]] intentFactor, [[Number]] intent, [[String]] intentChar)</code> | ||
+ | :Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | ||
+ | :;Parameter | ||
+ | ::;<code>[[Number]] intentFactor</code> | ||
+ | :::Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0). | ||
+ | ::;<code>[[Number]] intent</code> | ||
+ | :::Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0). | ||
+ | ::;<code>[[String]] intentChar</code> | ||
+ | :::Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' '). | ||
+ | :;Rückgabewert | ||
+ | ::;String | ||
+ | :::PHPArray als String. | ||
<noinclude> | <noinclude> | ||
[[Category:Objekte]] | [[Category:Objekte]] | ||
</noinclude> | </noinclude> |
Version vom 8. Januar 2014, 10:26 Uhr
Name
Collection - Liste beliebiger Objekte
Beschreibung
Eine Collection enthält eine beliebige Liste von Objekten. In einer Collection können Objekte hinzugefügt, geändert und gelöscht werden (siehe sp:collection). Auf einzelne Objekte der Collection kann mit Hilfe eines Index zugegriffen werden. Dazu steht folgende Syntax zur Verfügung.
myCollection[3]
Bei der Angabe des Index 3 wird das 4. Element der Collection zurückgeliefert, da die Collection mit dem Index 0 beginnt. Bei der Angabe eines negativen Index können die letzten Objekte der Collection erfragt werden, ohne das die Länge der Collection bekannt sein muß.
myCollection[-1]
Bei der Angabe des Index -1 wird das letzte Objekt der Collection zurückgeliefert. Bei einem Index von -2 würde das zweitletzte Objekt zurückgeliefert werden usw.
Um alle Objekte einer Collection nacheinander in einer Schleife zu durchlaufen kann der Tag sp:loop verwendet werden.
Ausgabe
Bei der Ausgabe dieses Objektes werden alle Einträgen kommasepariert ausgebeben.
Sonderregelung
Um den Umgang mit Collections zu vereinfachen gilt folgende Sondereregelung:
Wird auf die Collection ein Attribut abgefragt, das die Collection nicht besitzt, so wird dieses Attribut von dem ersten Eintrag der Liste abgefragt. Besitzt auch das erste Element der Liste dieses Attribut nicht, wird nichts zurück geliefert.
Attribute
Attribut | Type | Beschreibung | ab IES Version |
---|---|---|---|
size | Number | Anzahl der Objekte in der Collection | 1 |
Methoden
Methode | Rückgabewert | Beschreibung | ab IES Version |
---|---|---|---|
contains(Object o)
|
Boolean | Liefert true , wenn das Objekt in der Liste enthalten ist.
|
1 |
toJson()
|
String | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | 2.9 |
toJson(Number intentFactor)
|
String | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | 2.9 |
toJson(Number intentFactor, Number intent)
|
String | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | 2.9 |
toJson(Number intentFactor, Number intent, String intentChar)
|
String | Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann. | 2.9 |
toPhpArray()
|
String | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | 2.9 |
toPhpArray(Number intentFactor)
|
String | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | 2.9 |
toPhpArray(Number intentFactor, Number intent)
|
String | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | 2.9 |
toPhpArray(Number intentFactor, Number intent, String intentChar)
|
String | Erzeugt aus den Daten der Map einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann. | 2.9 |
Boolean contains(Object o)
- Liefert
true
, wenn das Objekt in der Collection enthalten ist. Alle Objekte der Liste werden mito
verglichen. Stimmt ein Objekt der Collection mito
überein wirdtrue
zurückgeliefert, sonstfalse
. Zu beachten ist, das die Objekte nicht direkt miteinander verglichen werden, sondern zunächst in ein Vergleichsobjekt umgewandelt werden. Bei Objekten, die eine ID besitzen wird diese ID als Vergleichsobjekt verwendet. Daraus folgt, dass nicht die Objekte selber miteinander verglichen werden, sondern lediglich deren IDs.- Parameter
-
Object o
- Objekt, das mit den Objekten der Collection verglichen werden soll.
- Rückgabewert
-
- Boolean
true
, wenn das Objekt enhalten ist, sonstfalse
.
String toJson(Number intentFactor, Number intent, String intentChar)
- Erzeugt aus den Daten der Map einen String in JSON, der mit sp:print ausgegeben werden kann.
- Parameter
- Rückgabewert
-
- String
- JSON als String.