KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Iterator::valid — De huidige positie van de iterator controleren

`Iterator::valid()` geeft aan of er op de huidige positie van de iterator een element staat. De methode test de waarde van dat element niet en schuift de iterator niet op.

Versie: PHP 8.3

Syntax

public function valid(): bool

Iterator::valid() is een instantiemethode zonder argumenten. Je roept haar aan als $iterator->valid(). De methode geeft true terug als er op de huidige positie een element staat en anders false. Ze verplaatst de iterator niet. Ook null, false en 0 kunnen geldige elementwaarden zijn.

Als foreach de Iterator-interface gebruikt, roept PHP eerst rewind() en daarna valid() aan. Bij true haalt de lus de waarde op met current() en zo nodig de sleutel met key(). Als de lus verdergaat, schuift next() de iterator op en controleert valid() de nieuwe positie. Bij false stopt de iteratie zonder op die positie een element te lezen. Bij een lege iterator geeft de eerste controle al false terug.

Controleer bij handmatige iteratie eerst valid() voordat je met current() of key() leest. Gebruikt je implementatie de positie als sleutel in de array $items, gebruik dan array_key_exists($position, $items) in plaats van isset($items[$position]): isset() geeft ook false terug voor een bestaande sleutel met de waarde null.

In PHP 8.3 is Iterator een ingebouwde interface. De klasse ArrayIterator maakt deel uit van de SPL-extensie, die niet kan worden uitgeschakeld.

Voorbeelden

<?php

$iterator = new ArrayIterator([null, false, 0]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    var_dump($iterator->current());
}

var_dump($iterator->valid());

Resultaat

NULL
bool(false)
int(0)
bool(false)

De eerste drie regels tonen elementwaarden uit `current()`. De `bool(false)` op de tweede regel is een elementwaarde; alleen de laatste `bool(false)` komt van `valid()` en betekent dat er op de huidige positie geen element staat.

Gerelateerde lessen

  • PHP · Les 61 · Gevorderd · Versie: 2
  • PHP · Les 63 · Gevorderd · Versie: 2

Bronnen