reset

reset

(PHP 4, PHP 5, PHP 7, PHP 8)

reset — Återställer den interna pekaren i en array till dess första element

Beskrivning

reset(array|object &$array): mixed

Funktionen reset() spolar tillbaka arrayens interna pekare till det första elementet och returnerar värdet av det första arrayelementet.

Parametrar

array

Den inmatade arrayen.

Returvärden

Returnerar värdet på det första arrayelementet, eller false om arrayen är tom.

Varning

Denna funktion kan returnera Boolean false, men kan också returnera ett icke-Boolean värde som utvärderas till false. Läs avsnittet om Booleans för mer information. Använd ===-operatorn för att testa returvärden av denna funktion.

Ändringslogg

Version	Beskrivning
8.1.0	Att anropa denna funktion på objekt är avskrivet. Konvertera antingen objektet till en array med get_mangled_object_vars() först, eller använd metoder som tillhandahålls av en klass som implementerar Iterator, såsom ArrayIterator, istället.
7.4.0	Instanser av SPL-klasser behandlas nu som tomma objekt som inte har några egenskaper istället för att anropa Iterator-metoden med samma namn som denna funktion.

Exempel

Exempel #1 Exempel på reset()

<?php

$array = array('steg ett', 'steg två', 'steg tre', 'steg fyra');

// som standard är pekaren på det första elementet
echo current($array) . "<br />\n"; // "steg ett"

// hoppa över två steg
next($array);
next($array);
echo current($array) . "<br />\n"; // "steg tre"

// återställ pekaren, börja om på steg ett
reset($array);
echo current($array) . "<br />\n"; // "steg ett"

?>

Anmärkningar

Notera: Returvärdet för en tom array är inte att skilja från returvärdet i fall av en array som har ett boolskt false som första element. För att korrekt kontrollera värdet på det första elementet i en array som kan innehålla false-element, kontrollera först count() av arrayen, eller kontrollera att key() inte är null, efter att ha anropat reset().

Se även

• current() - Returnerar det aktuella elementet i en array
• each() - Returnerar det aktuella nyckel- och värdeparet från en array och flyttar arraypekaren
• end() - Sätter den interna pekaren i en array till dess sista element
• next() - Flyttar den interna pekaren i en array
• prev() - Spolar tillbaka den interna arraypekaren
• array_key_first() - Hämtar den första nyckeln i en array

Arrayfunktioner