Funkcja PHP count()

Funkcja PHP count() zwraca liczbę elementów tablicy lub obiektu policzalnego (implementującego interfejs Countable).

Uwaga: W przypadku obiektu policzalnego funkcja count() zwraca wartość zwrotną metody Countable::count().

Składnia funkcji PHP count()

Funkcja PHP count() ma następującą składnię:

count(Countable|array $value, int $mode = COUNT_NORMAL): void

Parametry

Parametr	Opis
value	Parametr obowiązkowy. Tablica lub obiekt policzalny
mode	Parametr opcjonalny. Jego wartością domyślną jest `COUNT_NORMAL`. Jeśli zostanie ustawiony na `COUNT_RECURSIVE` (lub `1`), funkcja będzie liczyła elementy tablicy rekurencyjnie, co może się przydać w przypadku tablic wielowymiarowych

Wartość zwrotna

Funkcja PHP count() nie zwraca wartości.

Typ zwrotny: void.

Dodatkowe przykłady

Poniżej znajduje się parę dodatkowych przykładów użycia funkcji PHP count().

Funkcja PHP count() z obiektem policzalnym

Poniżej znajduje się definicja prostej klas o nazwie Computer, implementującej interfejs Countable. Dzięki temu obiekty tej klasy są policzalne. Jej metoda count() zwraca liczbę własności zdefiniowanych w obiekcie.

Następnie tworzymy przykładowy obiekt klasy Computer i za pomocą metody count() sprawdzamy liczbę zmiennych obecnych w tym obiekcie.


class Computer implements Countable {
  
  private $cpu;
  private $gpu;
  
  public function set_cpu($cpu) {
    $this->cpu = $cpu;
  }
  public function set_gpu($gpu) {
    $this->gpu = $gpu;
  }

  public function get_cpu() {
    return $this->cpu;
  }
  public function get_gpu() {
    return $this->gpu;
  }

  public function count(): int
  {
      return count(get_object_vars($this));
  }
}

$a = new Computer;
echo count($a);

Funkcja PHP count() z tablicą wielowymiarową

Poniższy przykład ilustruje różnice w działaniu funkcji count() z domyślnym parametrem COUNT_NORMAL i opcjonalnym parametrem COUNT_RECURSIVE.

$owady = array( "Karaczany" => array("Ectobius erythronotus", "Ectobius lapponicus", "Ectobius sylvestris"), "Pchły" => array("Pchła ludzka", "Pchła szczurza", "Pchła piaskowa"), "Psotniki" => array("Psotnik kołatek", "Psotnik zakamarnik", "Psotnik lalotek") ); echo "Wynik z COUNT_NORMAL: ", count($owady), "<br>"; echo "Wynik z COUNT_RECURSIVE: ", count($owady, COUNT_RECURSIVE);

Wynik:

Wynik z COUNT_NORMAL: 3
Wynik z COUNT_RECURSIVE: 12