Aller au contenu

count()

La fonction count() est une fonction intégrée de PHP qui retourne le nombre d'éléments dans un tableau ou le nombre de propriétés dans un objet. Elle fonctionne avec les tableaux, les objets et certains autres types de données.

Syntaxe de la fonction count()

La syntaxe de la fonction count() est simple. Elle prend un argument, qui est le tableau ou l'objet que vous souhaitez compter. La fonction retourne un entier représentant le nombre d'éléments ou de propriétés.

php
<?php

count(mixed $array_or_object, int $mode = COUNT_NORMAL): int

Note : La signature typée ci-dessus correspond à PHP 8.0+. À partir de PHP 8.0+, le passage d'un type non comptable (comme une chaîne ou un entier) lève une ValueError. Les versions précédentes de PHP ne disposent pas d'indicateurs de type stricts mais fonctionnent de manière identique. Note : sizeof() est un alias hérité de count() et se comporte de manière identique.

Le deuxième argument, $mode, est optionnel et sert à spécifier le comportement de la fonction count(). Il accepte deux valeurs possibles :

  • COUNT_NORMAL : C'est le mode par défaut et il se comporte de la même manière que la fonction count() sans le paramètre $mode. Il compte simplement le nombre d'éléments dans le tableau ou les propriétés dans l'objet.
  • COUNT_RECURSIVE : Ce mode compte récursivement les éléments dans les tableaux et objets imbriqués.
php
<?php

$data = array('apple', array('banana', 'cherry'));

echo count($data);           // Output: 2
echo count($data, COUNT_RECURSIVE); // Output: 4

Exemples d'utilisation de la fonction count()

Examinons quelques exemples pratiques de la manière dont la fonction count() peut être utilisée pour compter les éléments d'un tableau et les propriétés d'un objet.

Exemple 1 : Compter les éléments d'un tableau

Compter les éléments d'un tableau en PHP

php
<?php

$fruits = array('apple', 'banana', 'cherry');

echo count($fruits); // Output: 3

Dans cet exemple, nous avons un tableau appelé $fruits contenant trois éléments. La fonction count() retourne 3, représentant le nombre total d'éléments dans le tableau.

Exemple 2 : Compter les propriétés d'un objet

Compter les propriétés d'un objet en PHP

php
<?php

class Person implements Countable
{
    public $name;
    public $age;

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

$person = new Person();
$person->name = 'John';
$person->age = 30;

echo count($person); // Output: 2

Dans cet exemple, nous avons une classe simple appelée Person avec deux propriétés publiques, $name et $age. Nous créons une nouvelle instance de la classe Person et définissons les valeurs de ses propriétés. Comme la classe implémente l'interface Countable, l'appel de count($person) invoque la méthode count() personnalisée, qui retourne 2. Cela démontre comment le comportement de count() peut être personnalisé pour les objets.

Conclusion

La fonction count() est une fonction simple mais puissante en PHP qui peut être utilisée pour compter les éléments d'un tableau ou les propriétés d'un objet. En utilisant cette fonction, vous pouvez facilement déterminer le nombre d'éléments dans vos structures de données et utiliser ces informations pour écrire un code plus efficace et performant. En tant que programmeurs PHP expérimentés, nous recommandons d'utiliser la fonction count() dans votre stratégie de manipulation de données pour garantir que votre code soit évolutif et performant.

Pratique

Quelle est la fonctionnalité de la fonction 'count()' en PHP ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.