count_chars

(PHP 4, PHP 5, PHP 7, PHP 8)

count_chars — Gibt Informationen über die in einem String enthaltenen Zeichen zurück

Beschreibung

count_chars(string $string, int $mode = 0): array|string

Zählt die Häufigkeit des Vorkommens jedes einzelnen Byte-Wertes (0..255) in string und gibt sie auf verschiedene Arten zurück.

Parameter-Liste

string: Die zu untersuchende Zeichenkette.
mode: Siehe Rückgabewerte.

Rückgabewerte

Abhängig von mode gibt count_chars() eine der folgenden Möglichkeiten zurück:

0 - ein Array mit den Byte-Werten als Schlüssel und deren jeweiliger Häufigkeit als Wert.
1 - wie 0, allerdings werden nur Byte-Werte ausgegeben, die mindestens einmal vorkommen.
2 - wie 0, allerdings werden nur Byte-Werte, die nicht vorkommen, aufgelistet.
3 - eine Zeichenkette, die alle vorkommenden Zeichen enthält.
4 - eine Zeichenkette, die alle nicht vorkommenden Zeichen enthält.

Changelog

Version	Beschreibung
8.0.0	Vor dieser Version hat die Funktion bei Auftreten eines Fehlers `false` zurückgegeben.

Beispiele

Beispiel #1 count_chars()-Beispiel

<?php
$data = "Zwei Z und ein F.";

foreach (count_chars($data, 1) as $i => $val) {
   echo "Es gibt $val Vorkommen von \"" , chr($i) , "\" in der Zeichenkette.\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Es gibt 4 Vorkommen von " " in der Zeichenkette.
Es gibt 1 Vorkommen von "." in der Zeichenkette.
Es gibt 1 Vorkommen von "F" in der Zeichenkette.
Es gibt 2 Vorkommen von "Z" in der Zeichenkette.
Es gibt 1 Vorkommen von "d" in der Zeichenkette.
Es gibt 2 Vorkommen von "e" in der Zeichenkette.
Es gibt 2 Vorkommen von "i" in der Zeichenkette.
Es gibt 2 Vorkommen von "n" in der Zeichenkette.
Es gibt 1 Vorkommen von "u" in der Zeichenkette.
Es gibt 1 Vorkommen von "w" in der Zeichenkette.

Siehe auch

strpos() - Sucht die Position des ersten Vorkommens des Suchstrings in einem String
substr_count() - Ermittelt, wie oft eine Zeichenkette in einem String vorkommt