KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Iterator::next — naar het volgende element gaan

`Iterator::next()` zet een iterator één stap verder zonder het element terug te geven. Controleer bij handmatige iteratie eerst `valid()` voordat je de waarde met `current()` leest.

Versie: PHP 8.3

Syntax

public function Iterator::next(): void

Instance call: $iterator->next();

Iterator::next is een publieke instantiemethode van de interface Iterator. De aanroep $iterator->next() neemt geen argumenten aan en wijzigt de positie van hetzelfde object. In PHP 8.3 is void het voorlopige retourtype van deze interfacemethode. Dit is niet hetzelfde als de globale functie \next($array), die de interne aanwijzer van een array verplaatst en de waarde op de nieuwe positie teruggeeft, of false als er geen volgend element is.

In PHP 8.3 is Iterator ingebouwd en maakt de klasse ArrayIterator uit het voorbeeld deel uit van SPL, die altijd beschikbaar is. Je hoeft geen optionele extensie in te schakelen.

Begin bij handmatige iteratie met rewind(). Controleer de positie met valid() voordat je de waarde met current() of de sleutel met key() leest. Roep next() aan nadat je het element hebt verwerkt. Voorbij het laatste element geeft valid() false terug. Gebruik dat resultaat om het einde vast te stellen, niet de waarde van het element of het resultaat van next().

Bij een Iterator-object roept foreach aan het begin rewind() aan. Bij de overgang naar de volgende iteratie roept de lus next() aan en controleert ze valid(). Roep next() niet nog eens aan in de lus, tenzij je elementen wilt overslaan. Met break verlaat je de lus zonder nog een automatische stap.

Voorbeelden

<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();

while ($iterator->valid()) {
    echo $iterator->current(), "\n";
    $iterator->next();
}

var_dump($iterator->valid());

Resultaat

red
blue
bool(false)

Het voorbeeld gebruikt `ArrayIterator` uit SPL. Het toont eerst `red` en na de eerste stap `blue`. Na de tweede stap geeft `valid()` `false` terug, weergegeven als `bool(false)`.

Gerelateerde lessen

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

Bronnen