PHP-Handbuch: Gibt den Wert eines Offset-Punkts zurück

Beschreibung

abstract public mixed ArrayAccess::offsetGet ( mixed $offset )

Gibt den Wert des angegebenen Offset-Punkts zurück.

Diese Methode wird ausgeführt, wenn geprüft wird, ob ein Offset-Punkt empty ist.

Parameter-Liste

offset: Der zu untersuchende Offset-Punkt.

Anmerkungen

Hinweis:
Beginnend mit PHP 5.3.4 kann ArrayAccess::offsetGet per Referenz zurückgeben. Somit ist es möglich Array Offsets von Objekten welche mit ArrayAccess überladen wurden indirekt zu modifizieren.

Bei einer direkten Änderung wird der Wert eines Array Offsets komplett ersetzt (beispielsweise $obj[6] = 7). Bei einer indirekten Änderung wird nur ein Teil des Array Offsets geändert ($obj[6][7] = 7) oder das Array Offset einer Variablen per Referenz zugewiesen ($var =& $obj[6]). Auch Inkrementierung mit ++ und Dekrementierung mit -- sind derartig implementiert, dass sie indirekte Änderung erfordern.

Direkte Änderungen führen zu einem Aufruf von ArrayAccess::offsetSet, wohingegen indirekte Änderungen in einem Aufruf von ArrayAccess::offsetGet resultieren. In diesem Fall muss die Implementierung von ArrayAccess::offsetGet in der Lage sein per Referenz zurückzugeben, ansonsten wird ein E_NOTICE Fehler generiert.

Rückgabewerte

Kann Werte aller Typen zurückgeben.

Siehe auch

ArrayAccess::offsetExists