(PHP 4, PHP 5, PHP 7)
substr_count — Compte le nombre d'occurrences de segments dans une chaîne
$haystack
, string $needle
[, int $offset = 0
[, int $length
]] ) : int
substr_count() retourne le nombre d'occurrences
de needle dans la chaîne
haystack. Notez que needle
est sensible à la casse.
Note:
Cette fonction ne compte pas les chaînes de caractères qui se recouvrent. Voyez l'exemple ci-dessous !
haystackLa chaîne de caractères pour rechercher à l'intérieur
needleLa chaîne de caractères que l'on recherche
offsetLe décalage où on commence à compter. Si la position est négative, le comptage commence depuis la fin de la chaîne.
length
La taille maximale après le décalage spécifié pour rechercher la
chaîne. La fonction émet une erreur si le décalage plus la taille est
plus grand que la taille de haystack.
Une taille négative fera que le comptage commencera à la fin de
haystack.
Cette fonction retourne un entier.
| Version | Description |
|---|---|
| 7.1.0 |
Ajout du support des nombres négatifs pour offset
et length.
length peut aussi être 0 maintenant.
|
| 5.1.0 |
Ajout des paramètres offset et
length
|
Exemple #1 Exemple avec substr_count()
<?php
$text = 'Ceci est un test';
echo strlen($text); // 16
echo substr_count($text, 'est'); // 2
// la chaîne de caractères est réduite à 'st un test', alors elle affiche 1
echo substr_count($text, 'est', 6);
// le texte est réduit à 'st u', alors elle affiche 0
echo substr_count($text, 'est', 6, 4);
// génère une erreur parce que 8+10 > 16
echo substr_count($text, 'est', 8, 10);
// affiche seulement 1, parce que elle ne compte pas les chaînes de caractères
// qui se recouvrent
$text2 = 'gcdgcdgcd';
echo substr_count($text2, 'gcdgcd');
?>