reset

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

resetBir dizinin dahili göstericisini ilk elemana konumlar

Açıklama

reset ( array|object &$dizi ) : mixed

reset() işleve dizi dizisinin dahili göstericisini ilk elemana konumlar ve ilk dizi elemanının değeri ile döner.

Uyarı

Bu işlev mantıksal false değeriyle dönebileceği gibi false olarak değerlendirilebilecek mantıksal olmayan bir değerle de dönebilir. Bu konuda daha fazla bilgi Mantıksal Değerler bölümünde bulunabilir. Bu işlevden dönen değeri sınamak için === işleci kullanılabilir.

Değiştirgeler

dizi

Dahili göstericisi sıfırlanacak dizi.

Dönen Değerler

Dizi boşsa false, değilse dizinin ilk elemanının değeri.

Örnekler

Örnek 1 - reset() örneği

<?php

$dizi 
= array('bir adım''iki adım''üç adım''dörtadım');

// Öntanımlı olarak gösterici ilk elemandadır
echo current($dizi) . "\n"// "bir adım"

// İki adım atalım
next($dizi);
next($dizi);
echo 
current($dizi) . "\n"// "üç adım"

// Göstericiyi sıfırlayalım
reset($dizi);
echo 
current($dizi) . "\n"// "bir adım"

?>

Notlar

Bilginize: İlk eleman değerinin bool false olduğu durum ile boş bir diziden dönen değer arasında bir fark yoktur. false elemanlar içeren bir dizinin ilk eleman değerini bilinçli olarak elde etmek için önce count() işlevinin dönüş değerine bakılmalı ya da reset() işlevini çağırdıktan sonra key() işlevinin null döndürmediği doğrulanmalıdır.

Ayrıca Bakınız

  • current() - Bir diziden gösterici konumundaki elemanı döndürür
  • each() - Bir diziden, gösterici konumundaki anahtar değer çiftini döndürdükten sonra göstericiyi bir ilerletir
  • end() - Bir dizinin dahili göstericisini sonuncu elemana konumlandırır
  • next() - Dahili dizi göstericisini bir ilerletir
  • prev() - Dahili dizi göstericisini bir geriletir
  • array_key_first() - Dizinin ilk anahtarı ile döner