count

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

countBir dizideki eleman sayısını veya bir nesnedeki şeylerin sayısını döndürür

Açıklama

count ( Countable|array $girdi , int $kip = COUNT_NORMAL ) : int

Bir dizideki eleman sayısını veya bir nesnedeki şeylerin sayısını döndürür.

Nesneler için, eğer SPL kuruluysa Countable tarafından gerçeklenen Countable::count() yöntemini sonucu almak için kullanabilirsiniz. Nesne arayüzü sadece bir yönteme, count() işlevinden dönen değeri döndüren Countable::count() yöntemine sahiptir.

PHP'de kullanılan dizilerin nasıl gerçeklendiği ile ilgili daha ayrıntılı bilgi edinmek için array sayfasına bakınız.

Değiştirgeler

girdi

Dizi veya Countable nesnesi.

kip

İsteğe bağlı kip değiştirgesine COUNT_RECURSIVE (veya 1) atanırsa, count() işlevi diziyi ardışık olarak sayar. Böylece çok boyutlu bir dizinin bütün elemanları sayılabilir. count() sonsuz iç içeliği algılayacak yetenekte değildir.

Dikkat

count() işlevi sonsuz döngüden kaçınmak için iç içeliği saptayabilir, fakat bunu her yaptığında (dizinin kendisini birden fazla içerdiği durumda) bir E_WARNING çıktılar ve beklenenden daha yüksek bir miktar döndürür.

Dönen Değerler

girdi'deki eleman sayısını döndürür. girdi bir dizi veya Countable arayüzü ile gerçeklenmiş bir nesne değilse 1 döner. Tek istisnası girdi'nin null olması durumu olup böyle bir durumda 0 döner.

Örnekler

Örnek 1 - count() örneği

<?php
$a
[0] = 1;
$a[1] = 3;
$a[2] = 5;
var_dump(count($a));

$b[0]  = 7;
$b[5]  = 9;
$b[10] = 11;
var_dump(count($b));

var_dump(count(null));

var_dump(count(false));
?>

Yukarıdaki örneğin çıktısı:

int(3)
int(3)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 12 // PHP 7.2 ve sonrası
int(0)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14 // PHP 7.2 ve sonrası
int(1)

Örnek 2 - Ardışık count() örneği

<?php
$food 
= array('fruits' => array('orange''banana''apple'),
              
'veggie' => array('carrot''collard''pea'));

// ardışık sayım
echo count($foodCOUNT_RECURSIVE); // 8

// normal sayım
echo count($food); // 2

?>

Sürüm Bilgisi

Sürüm: Açıklama
7.2.0 count() işlevi girdi olarak geçersiz sayılabilir türler aktarıldığında artık bir uyarı çıktılamaktadır.

Ayrıca Bakınız

  • empty() - Bir değişkenin boş olup olmadığını saptar
  • is_array() - Değişkenin bir dizi içerip içermediğine bakar
  • is_countable() - Verify that the contents of a variable is a countable value
  • isset() - Değişken tanımlı mı diye bakar
  • strlen() - Dizge uzunluğunu döndürür