Manual:ApiResult.php/de

Die ApiResult-Klasse stellt das Ergebnis der API-Befehle dar.

Sie umschließt einfach eine verschachtelte array-Struktur und fügt einige Funktionen hinzu, um die Veränderungen des Arrays zu vereinfachen. Während verschiedene Module ausgeführt werden, fügen sie unterschiedliche Informationsteile zum Ergebnis hinzu und strukturieren es so, wie es an den Client übergeben wird.

Jedes Subarray kann entweder ein Wörterbuch sein - Schlüssel-Wert-Paare mit einzigartigen Schlüsseln oder Listen, in denen die Objekte mit -Notation hinzugefügt werden.

Es gibt zwei Spezial-Schlüsselwerte, die ändern, wie die XML-Ausgabe generiert wird:


 * '_element' - Dieser Schlüssel legt den Markierungsnamen für den Rest der Elemente in dem aktuellen Array fest. Es wird nur eingesetzt, wenn der Formatierer für getNeedsRawData true zurückgegeben hat.
 * '*' - Dieser Schlüssel hat nur für den XML-Formatierer eine besondere Bedeutung und wird wie für alle anderen ausgegeben. In XML wird es zum Inhalt des aktuellen Elements.

addValue
Fügt den Wert zu den Ausgabedaten in dem angegebenen Pfad hinzu.

Path can be an indexed array, each element specifying the branch at which to add the new value. Setting $path to array('a','b','c') is equivalent to data['a']['b']['c'] = $value. If $path is null, the value will be inserted at the data root. Wenn $name leer ist, wird $value als nächstes Listenelement data[] = $value hinzugefügt.