PHP Handbuch
Zurück |  | Weiter

# 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.

> Anmerkung: 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()

Zurück | Zum Anfang | Weiter
substr_compare | Nach oben | substr_replace