current

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

    current — Bir diziden gösterici konumundaki elemanı döndürür

    Açıklama

    current(array|object$dizi): mixed

    Her dizinin, ilklendirme anında ilk elemanını konumlayan bir göstericisi vardır.

    Bağımsız Değişkenler

    dizi

    Üzerinde işlem yapılacak dizi.

    Dönen Değerler

    current() işlevi dizinin dahili göstericinin işaret ettiği elemanı döndürür. Göstericinin yeri değiştirilmez. Eğer gösterici sonuncu elemanın sonrasını işaret ediyorsa veya dizi boşsa false 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.

    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 - current() örneği

    <?php
    $araç     = array('tabanvay', 'bisiklet', 'otomobil', 'uçak');
    $kip = current($araç); // $kip = 'tabanvay';
    $kip = next($araç); // $kip = 'bisiklet';
    $kip = current($araç); // $kip = 'bisiklet';
    $kip = next($araç); // $kip = 'otomobil';
    $kip = prev($araç); // $kip = 'bisiklet';
    $kip = end($araç); // $kip = 'uçak';
    $kip = current($araç); // $kip = 'uçak';

    $arr = array();
    var_dump(current($arr)); // bool(false)

    $arr = array(array());
    var_dump(current($arr)); // array(0) { }
    ?>

    Notlar

    Bilginize: current() işlevini dahili göstericisi öğelerin sonunun ötesini gösteren boş bir dizi ile çağırmanın sonuçları boolfalse öğesinden ayırt edilemez. false elemanlar içerebilecek bir dizide bilinçli olarak ilerlemenin en doğru yolu foreach kullanmaktır. Yine de current() kullanmak ve değerin gerçekten dizinin bir öğesi olup olmadığını doğru bir şekilde kontrol etmek için, anahtarın null olmadığından kesinlikle emin olunmalıdır.

    Ayrıca Bakınız

    • end() - Bir dizinin dahili göstericisini sonuncu elemana konumlandırır
    • key() - Bir diziden gösterici konumundaki anahtarı döndürür
    • each() - Bir diziden, gösterici konumundaki anahtar değer çiftini döndürdükten sonra göstericiyi bir ilerletir
    • prev() - Dahili dizi göstericisini bir geriletir
    • reset() - Bir dizinin dahili göstericisini ilk elemana konumlar
    • next() - Dahili dizi göstericisini bir ilerletir
    • foreach
    To Top