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.0SPL 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 boolfalse 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
    To Top