ArrayAccess::offsetGet

(PHP 5, PHP 7, PHP 8)

ArrayAccess::offsetGet — 獲取一個(gè)偏移位置的值

說明

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

返回指定偏移位置的值。

當(dāng)檢查一個(gè)偏移位置是否為 empty() 時(shí)，會執(zhí)行此方法。

參數(shù)

offset

需要獲取的偏移位置。

返回值

可返回任何類型。

注釋

注意:

此方法的實(shí)現(xiàn)可以通過引用返回。 這使得可以間接修改 ArrayAccess 對象，能夠重載數(shù)組的維度。

直接修改是完全替代數(shù)組維度的值，例如 $obj[6] = 7。 另一方面，間接修改是指僅修改某個(gè)維度中的一部分，或者傳引用的方式賦值一個(gè)維度， 例如 $obj[6][7] = 7 和 $var =& $obj[6]。 使用 ++ 自增或者使用 -- 自減也是通過間接修改的方式實(shí)現(xiàn)的。

直接修改會觸發(fā)對 ArrayAccess::offsetSet() 的調(diào)用，而間接修改則會觸發(fā)對 ArrayAccess::offsetGet() 的調(diào)用。在這種情況下， ArrayAccess::offsetGet() 的實(shí)現(xiàn)必須能通過引用返回，否則會引發(fā) E_NOTICE 消息。

參見