CKTIS / PHP
SplFixedArray::offsetSet — Einen Wert an einem Index schreiben
Schreibe oder ersetze einen Wert in einem Array mit fester Größe. Vergleiche den direkten Methodenaufruf mit der Zuweisung per eckigen Klammern und unterscheide die Indexfehler in PHP 8.3.
Version: PHP 8.3
Syntax
$array->offsetSet($index, $value);
$array[$index] = $value;SplFixedArray::offsetSet schreibt in eine vorhandene Position eines \SplFixedArray-Objekts. Die SPL-Klasse liegt im globalen Namensraum. SPL gehört zum PHP-Kern und ist in Standard-Builds von PHP 8.3 immer aktiviert. Bei einem gültigen ganzzahligen Index schreiben $array->offsetSet($index, $value) und $array[$index] = $value an dieselbe Position. Der Wert darf einen beliebigen Typ haben (mixed), auch null ist möglich. Die Methode ändert das Objekt und gibt keinen Wert zurück (void).
Ein gültiger Index erfüllt 0 <= $index && $index < $array->getSize(). Bei Größe 2 sind Schreibzugriffe an den Indizes 0 und 1 möglich, nicht aber an Index 2. Das Schreiben ändert die Größe nicht, und $array[] = $value hängt anders als bei einem gewöhnlichen PHP-Array kein Element an. Für zusätzliche Positionen rufst du zuerst setSize() auf und schreibst dann an einen expliziten Index.
In PHP 8.3 löst ein ganzzahliger Index außerhalb des gültigen Bereichs eine RuntimeException aus, ein unzulässiger Schlüssel wie 'label' hingegen einen TypeError. Ab PHP 8.4 ist die konkrete Ausnahmeklasse für einen Index außerhalb des Bereichs OutOfBoundsException, eine Unterklasse von RuntimeException. Stammt der Index aus einer externen Eingabe, prüfe is_int($index) und den Bereich, statt dich auf eine implizite Umwandlung zu verlassen.
Beispiele
<?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";
}
Ergebnis
draft ready RuntimeException TypeError
Das Skript speichert mit der Methode `draft` an Index 1 und ersetzt den Wert dann per Zuweisung mit eckigen Klammern durch `ready`. Anschließend gibt es die Ausnahmeklassen für Index 2 beziehungsweise den Schlüssel `'label'` aus.
Zugehörige Lektionen
- PHP · Lektion 66 · Fortgeschritten · Version: 2