CKTIS / PHP
SplFixedArray::offsetGet — четене на елемент по индекс
Прочети стойност с `offsetGet()` или `[]` и разграничи `null` от индекс извън допустимия диапазон или индекс от неподдържан тип.
Версия: PHP 8.3
Синтаксис
$value = $array->offsetGet($index);
$value = $array[$index];SplFixedArray::offsetGet е метод на екземпляр, който връща стойността на посочения индекс. Връщаният тип е mixed: съхранената стойност запазва своя тип. Благодарение на ArrayAccess обикновено четене чрез $array[$index] дава същия резултат като $array->offsetGet($index). Класът е част от SPL, която е вградена в PHP 8.3 и не може да бъде изключена. В именувано пространство от имена използвай \SplFixedArray или импортирай SplFixedArray.
Индексите започват от нула и трябва да удовлетворяват 0 <= $index && $index < $array->getSize(). Четенето от валидна позиция, на която никога не е присвоявана стойност, връща null. Четенето на изрично записана стойност null дава същия резултат. Само по върнатата стойност не можеш да различиш двата случая.
В PHP 8.3 целочислен индекс извън диапазона предизвиква RuntimeException, а неподдържан тип на индекса, например низът 'name', предизвиква TypeError. От PHP 8.4 грешката при излизане извън диапазона е OutOfBoundsException, подклас на RuntimeException. Преди PHP 8.1 неподдържаните ключове предизвикваха RuntimeException. Проверявай типа и диапазона на индексите от външни данни, вместо да разчиташ на неявно преобразуване: например при четене с [] низът '0' може да се използва като индекс 0.
Методът не връща референция към позицията. За да промениш вложен PHP масив, прочети го в променлива, промени го и го запиши обратно чрез $array[$index] = $value или $array->offsetSet($index, $value).
Примери
<?php
$array = new \SplFixedArray(2);
$array[0] = 42;
var_dump($array->offsetGet(0));
var_dump($array[0]);
var_dump($array->offsetGet(1));
foreach ([2, 'name'] as $index) {
try {
$array->offsetGet($index);
} catch (\RuntimeException | \TypeError $error) {
echo get_class($error), "\n";
}
}
Резултат
int(42) int(42) NULL RuntimeException TypeError
И двата начина на четене връщат `int(42)`. Позицията без присвоена стойност дава `NULL`, а последните два реда показват очакваните класове на изключенията в PHP 8.3.
Свързани уроци
- PHP · Урок 66 · Напреднало · Версия: 2