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