Manuel PHP
Précédent |  | Suivant

# substr_count

(PHP 4, PHP 5)

substr_count -- Compte le nombre d'occurrences de segments dans une chaîne

## Description

int substr_count ( string haystack, string needle [, int offset [, 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

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.

## Valeurs de retour

Cette fonction retourne un entier.

## Historique

Version | Description
--- | ---
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()
strpos()
substr()
strstr()

Précédent | Sommaire | Suivant
substr_compare | Niveau supérieur | substr_replace