substr_compare
substr_replace
String-Funktionen
PHP Manual

# substr_count

(PHP 4, PHP 5)

substr_count — Ermittelt, wie oft eine Zeichenkette in einem String vorkommt

### Beschreibung

int substr_count ( string `$haystack` , string `$needle` [, int `$offset` [, int `$length` ]] )

Die Funktion substr_count() ermittelt, wie oft `needle` in dem String `haystack` vorkommt, und gibt die Anzahl der Vorkommen zurück. Beachten Sie, dass der Parameter `needle` case sensitive ist.

> Hinweis: Die Funktion zählt einander überlappende Substrings nicht mit. Beachten Sie das untenstehende Beispiel!

### Parameter-Liste

`haystack`

  Der String, in dem gesucht werden soll

`needle`

  Der Substring, nach dem gesucht werden soll

`offset`

  Die Zeichenposition, an der die Zählung begonnen werden soll

`length`

  Die maximale Länge nach dem angegebenen Offset, in der nach dem Substring gesucht werden soll. Es wird eine Warnung ausgegeben, wenn Offset plus Länge größer als die Länge von `haystack` sind.

### Rückgabewerte

Die Funktion gibt einen Wert vom Typ integer zurück.

### ChangeLog

Version | Beschreibung
--- | ---
5.1.0 | Hinzufügen der Parameter `offset` und `length`

### Beispiele

Beispiel #1 Ein substr_count() Beispiel

`<?php
$text = 'Dies ist ein Test';
echo strlen($text); // 17
echo substr_count($text, 'es'); // 2
// wird der String auf 's ist ein Test' reduziert,
// lautet das ausgegebene Ergebnis 1
echo substr_count($text, 'es', 3);
// wird der String auf 's i' reduziert,
// lautet das Ergebnis 0
echo substr_count($text, 'es', 3, 3);
// generiert eine Warnung, da 5+13 > 17
echo substr_count($text, 'es', 5, 13);
// gibt 1 aus, da überlappende Substrings nicht gezählt werden
$text2 = 'gcdgcdgcd';
echo substr_count($text2, 'gcdgcd');
?>`

### Siehe auch

- count_chars()
- strpos()
- substr()
- strstr()

substr_compare
substr_replace
String-Funktionen
PHP Manual