KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

SplFixedArray::offsetGet — een element lezen op index

Lees een positie met `offsetGet()` of `[]` en onderscheid een `null`-waarde van een index buiten bereik of een niet-ondersteund indextype.

Versie: PHP 8.3

Syntax

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

SplFixedArray::offsetGet is een instantiemethode die de waarde op de gevraagde index teruggeeft. Het retourtype is mixed: de opgeslagen waarde behoudt haar type. Dankzij ArrayAccess geeft een gewone leesbewerking met $array[$index] hetzelfde resultaat als $array->offsetGet($index). De klasse hoort bij SPL, dat in PHP 8.3 is ingebouwd en niet kan worden uitgeschakeld. Gebruik binnen een benoemde naamruimte \SplFixedArray of importeer SplFixedArray.

Indices beginnen bij nul en moeten voldoen aan 0 <= $index && $index < $array->getSize(). Een geldige positie waaraan nooit een waarde is toegekend, levert bij het lezen null op. Een expliciet opgeslagen null geeft hetzelfde resultaat. Aan de retourwaarde alleen kun je deze gevallen niet onderscheiden.

In PHP 8.3 veroorzaakt een gehele index buiten het bereik een RuntimeException; een niet-ondersteund indextype, zoals bij de tekenreeks 'name', veroorzaakt een TypeError. Vanaf PHP 8.4 is de bereikfout een OutOfBoundsException, een subklasse van RuntimeException. Vóór PHP 8.1 veroorzaakten niet-ondersteunde sleutels een RuntimeException. Controleer het type en bereik van indices uit externe invoer in plaats van op impliciete omzetting te vertrouwen: bij lezen met [] kan de tekenreeks '0' bijvoorbeeld als index 0 worden behandeld.

De methode geeft geen referentie naar de positie terug. Wil je een geneste PHP-array wijzigen, lees die dan in een variabele, pas die aan en schrijf de array terug met $array[$index] = $value of $array->offsetSet($index, $value).

Voorbeelden

<?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";
    }
}

Resultaat

int(42)
int(42)
NULL
RuntimeException
TypeError

Beide leesvormen geven `int(42)` terug. De positie zonder toegewezen waarde levert `NULL` op en de laatste twee regels tonen de verwachte uitzonderingsklassen in PHP 8.3.

Gerelateerde lessen

  • PHP · Les 66 · Gevorderd · Versie: 2

Bronnen