reset

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

reset — Bir 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.

Bağımsız Değişkenler

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.

Sürüm Bilgisi

Sürüm:	Açıklama
8.1.0	Bu işlevin nesnelerden çağrılması artık önerilmiyor. Ya nesne önce get_mangled_object_vars() kullanılarak bir diziye dönüştürülmeli ya da bunun yerine Iterator arayüzünü gerçekleyen bir sınıf tarafından sağlanan ArrayIterator gibi yöntemler kullanılmalıdır.
7.4.0	SPL sınıflarının örnekleri, artık bu işlevle aynı ada sahip Iterator yöntemini çağırmak yerine hiçbir özelliği olmayan boş nesneler gibi ele alınıyor.

Ö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