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

CKTIS / PHP

SplFixedArray::offsetSet — Запис на стойност по индекс

Запиши или замени стойност в масив с фиксиран размер. Сравни прякото извикване с присвояването чрез квадратни скоби и разграничи грешките при индексиране в PHP 8.3.

Версия: PHP 8.3

Синтаксис

$array->offsetSet($index, $value);
$array[$index] = $value;

SplFixedArray::offsetSet записва стойност на съществуваща позиция в обект от класа \SplFixedArray. Класът е част от SPL и е в глобалното пространство от имена. SPL е част от ядрото на PHP и винаги е активирана в стандартните компилации на PHP 8.3. При валиден целочислен индекс $array->offsetSet($index, $value) и $array[$index] = $value записват на една и съща позиция. Стойността може да е от произволен тип (mixed), включително null. Методът променя обекта и не връща стойност (void).

Валидният индекс изпълнява условието 0 <= $index && $index < $array->getSize(). При размер 2 можеш да записваш на индекси 0 и 1, но не и на индекс 2. Записът не променя размера, а $array[] = $value не добавя елемент в края, както при обикновен PHP масив. За да добавиш позиции, първо извикай setSize(), след което запиши стойност на изрично посочен индекс.

В PHP 8.3 целочислен индекс извън диапазона предизвиква RuntimeException, а невалиден ключ като 'label' предизвиква TypeError. От PHP 8.4 конкретният клас на изключението за индекс извън диапазона е OutOfBoundsException, подклас на RuntimeException. Ако индексът идва от външен вход, провери is_int($index) и диапазона, вместо да разчиташ на неявно преобразуване.

Примери

<?php
$array = new \SplFixedArray(2);

$array->offsetSet(1, 'draft');
echo $array[1], "\n";

$array[1] = 'ready';
echo $array[1], "\n";

try {
    $array->offsetSet(2, 'extra');
} catch (\RuntimeException $error) {
    echo get_class($error), "\n";
}

try {
    $array['label'] = 'extra';
} catch (\TypeError $error) {
    echo get_class($error), "\n";
}

Резултат

draft
ready
RuntimeException
TypeError

Скриптът записва `draft` на индекс 1 чрез метода, след което заменя стойността с `ready` чрез квадратни скоби. Накрая извежда имената на класовете, съответно за индекс 2 и за ключа `'label'`.

Свързани уроци

  • PHP · Урок 66 · Напреднало · Версия: 2

Източници