База знанияИзпитен център
BGБългарски
Избери език13

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

Източници