current

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

currentBir 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.

Değiştirgeler

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
7.0.0 dizi artık daima değeri ile aktarılmaktadır. Evvelce, mümkünse gönderimli değilse değeriyle aktarılırdı.

Ö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ı bool false öğ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