Note:Classes that implement XHPChild must do so by implementing the XHPChildClass subinterface.
<?hhclass Obj<string, string> implements ArrayAccess<string, string> {
private array $container = array();
public function __construct() {
$this->container = array(
"one" => 1,
"two" => 2,
"three" => 3,
);
}
public function offsetSet(string $key, string $value): this {
if (is_null($key)) {
$this->container[] = $value;
} else {
$this->container[$key] = $value;
}
}
public function offsetExists(string $offset): bool {
return isset($this->container[$offset]);
}
public function offsetUnset(string $offset): this {
unset($this->container[$offset]);
}
public function offsetGet(string $offset): ?string {
return isset($this->container[$offset]) ? $this->container[$offset] : null;
}
}$obj = new Obj();var_dump(isset($obj["two"]));var_dump($obj["two"]);
unset($obj["two"]);var_dump(isset($obj["two"]));$obj["two"] = "A value";var_dump($obj["two"]);$obj[] = 'Append 1';$obj[] = 'Append 2';$obj[] = 'Append 3';print_r($obj);bool(true)
int(2)
bool(false)
string(7) "A value"
obj Object
(
[container:obj:private] => Array
(
[one] => 1
[three] => 3
[two] => A value
[0] => Append 1
[1] => Append 2
[2] => Append 3
)
)
$offset )Note:When using empty() ArrayAccess::offsetGet() will be called and checked if empty only ifArrayAccess::offsetExists() returnsTRUE.
key<?hhclass Obj<Tk, Tv> implements ArrayAccess<Tk, Tv> {
public function offsetSet(Tk $offset, Tv $value): this {
var_dump(__METHOD__);
}
public function offsetExists(Tk $var): bool {
var_dump(__METHOD__);
if ($var == "foobar") {
return true;
}
return false;
}
public function offsetUnset(Tk $var): this {
var_dump(__METHOD__);
}
public function offsetGet(Tk $var): Tv {
var_dump(__METHOD__);
return "value";
}
}$obj = new Obj();
echo "Runs obj::offsetExists()\n";var_dump(isset($obj["foobar"]));
echo "\nRuns obj::offsetExists() and obj::offsetGet()\n";var_dump(empty($obj["foobar"]));
echo "\nRuns obj::offsetExists(), *not* obj:offsetGet() as there is nothing to get\n";var_dump(empty($obj["foobaz"]));?>Runs obj::offsetExists() string(17) "obj::offsetExists" bool(true) Runs obj::offsetExists() and obj::offsetGet() string(17) "obj::offsetExists" string(14) "obj::offsetGet" bool(false) Runs obj::offsetExists(), *not* obj:offsetGet() as there is nothing to get string(17) "obj::offsetExists" bool(true)
keyNote:Starting with PHP 5.3.4, the prototype checks were relaxed and it's possible for implementations of this method to return by reference. This makes indirect modifications to the overloaded array dimensions of ArrayAccess<Tk, Tv>objects possible.A direct modification is one that replaces completely the value of the array dimension, as in $obj[6] = 7. An indirect modification, on the other hand, only changes part of the dimension, or attempts to assign the dimension by reference to another variable, as in $obj[6][7] = 7 or $var =& $obj[6]. Increments with ++ and decrements with -- are also implemented in a way that requires indirect modification.While direct modification triggers a call to ArrayAccess::offsetSet(), indirect modification triggers a call toArrayAccess::offsetGet(). In that case, the implementation of ArrayAccess::offsetGet() must be able to return by reference, otherwise anE_NOTICEmessage is raised.
$key , Tv $val )keyvalNote:Thekeyparameter will be set toNULLif another value is not available, like in the following example.<?hh
$arrayaccess[] = "first value";$arrayaccess[] = "second value";print_r($arrayaccess);?>The above example will output:Array ( [0] => first value [1] => second value )
Note:This function is not called in assignments by reference and otherwise indirect changes to array dimensions overloaded with ArrayAccess (indirect in the sense they are made not by changing the dimension directly, but by changing a sub-dimension or sub-property or assigning the array dimension by reference to another variable). Instead,ArrayAccess::offsetGet() is called. The operation will only be successful if that method returns by reference, which is only possible since PHP 5.3.4.
$key )Note:
key