CKTIS / PHP
SplFixedArray::offsetSet — Een waarde schrijven op een index
Schrijf of vervang een waarde in een array met een vaste grootte. Vergelijk de directe methodeaanroep met toewijzing via vierkante haken en onderscheid de indexfouten in PHP 8.3.
Versie: PHP 8.3
Syntax
$array->offsetSet($index, $value);
$array[$index] = $value;SplFixedArray::offsetSet schrijft naar een bestaande positie in een \SplFixedArray-object. Deze SPL-klasse staat in de globale naamruimte. SPL maakt deel uit van de PHP-kern en is altijd ingeschakeld in standaardbuilds van PHP 8.3. Met een geldige gehele index schrijven $array->offsetSet($index, $value) en $array[$index] = $value naar dezelfde positie. De waarde mag elk type hebben (mixed), inclusief null. De methode wijzigt het object en geeft geen waarde terug (void).
Een geldige index voldoet aan 0 <= $index && $index < $array->getSize(). Bij grootte 2 kun je schrijven op index 0 en 1, maar niet op 2. Schrijven verandert de grootte niet, en $array[] = $value voegt anders dan bij een gewone PHP-array geen element achteraan toe. Wil je meer posities, roep dan eerst setSize() aan en schrijf daarna naar een expliciete index.
In PHP 8.3 leidt een gehele index buiten het bereik tot RuntimeException, terwijl een ongeldige sleutel zoals 'label' tot TypeError leidt. Vanaf PHP 8.4 is de specifieke uitzonderingsklasse voor een index buiten het bereik OutOfBoundsException, een subklasse van RuntimeException. Komt de index uit externe invoer, controleer dan is_int($index) en het bereik in plaats van op impliciete conversie te vertrouwen.
Voorbeelden
<?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";
}
Resultaat
draft ready RuntimeException TypeError
Het script schrijft met de methode `draft` op index 1 en vervangt die waarde vervolgens via vierkante haken door `ready`. Ten slotte toont het de namen van de uitzonderingsklassen voor respectievelijk index 2 en de sleutel `'label'`.
Gerelateerde lessen
- PHP · Les 66 · Gevorderd · Versie: 2