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