substr_count
(PHP 4, PHP 5, PHP 7)
substr_count — Compte le nombre d'occurrences de segments dans une chaîne
Description
$haystack
, string $needle
[, int $offset = 0
[, int $length
]] )
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 !
Liste de paramètres
-
haystack -
La chaîne de caractères pour rechercher à l'intérieur
-
needle -
La chaîne de caractères que l'on recherche
-
offset -
Le 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 dehaystack.
Historique
| Version | Description |
|---|---|
| 7.1.0 |
Ajout du support des nombres négatifs pour offset
et length.
|
| 5.1.0 |
Ajout des paramètres offset et
length
|
Exemples
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');
?>
Voir aussi
- count_chars() - Retourne des statistiques sur les caractères utilisés dans une chaîne
- strpos() - Cherche la position de la première occurrence dans une chaîne
- substr() - Retourne un segment de chaîne
- strstr() - Trouve la première occurrence dans une chaîne
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.substr-count.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
