PHP Manual
String-Funktionen
Liefert Informationen über in einem String verwendete Worte

str_word_count

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

str_word_count — Liefert Informationen über in einem String verwendete Worte

Beschreibung

str_word_count(string $string, int $format = 0, ?string $characters = null): array|int

Zählt die Wörter in string. Wenn der optionale Parameter format nicht angegeben ist, wird ein Integer mit der Anzahl der gefundenen Wörter zurückgegeben. Falls format angegeben ist, ist der Rückgabewert ein Array, dessen Inhalt von format abhängt. Die möglichen Werte von format und die daraus resultierenden Ausgaben sind unten aufgelistet.

Bei der Verwendung dieser Funktion, werden "Wörter" als Locale-abhängige Strings interpretiert, die nur die Buchstaben des Alphabets enthalten. Sie dürfen außerdem "'"- und "-"-Zeichen enthalten, jedoch nicht damit beginnen. Beachten Sie, dass Locales, die Multibyte-Strings verwenden, nicht unterstützt werden.

Parameter-Liste

string

Die Zeichenkette

format

Gibt den Rückgabewert der Funktion an. Die folgenden Werte werden derzeit unterstützt:

0 - gibt die Anzahl der gefundenen Wörter zurück
1 - gibt einen Array zurück, das alle innerhalb von string gefundenen Wörter enthält.
2 - gibt ein asoziatives Array zurück, dessen Schlüssel die numerische Position des Wortes innerhalb von string angibt und dessen Wert das eigentliche Wort ist

characters

Eine Liste zusätzlicher Zeichen, die ebenfalls als 'Wort' betrachtet werden

Rückgabewerte

Gibt abhängig vom gewählten format ein Array oder ein Integer zurück.

Changelog

Version	Beschreibung
8.0.0	`characters` ist jetzt nullable (akzeptiert den NULL-Wert).

Beispiele

Beispiel #1 Ein str_word_count()-Beispiel


<?php

$str = "Hello fri3nd, you're
       looking          good today!";

print_r(str_word_count($str, 1));
print_r(str_word_count($str, 2));
print_r(str_word_count($str, 1, 'àáãç3'));

echo str_word_count($str);

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => Hello
    [1] => fri
    [2] => nd
    [3] => you're
    [4] => looking
    [5] => good
    [6] => today
)

Array
(
    [0] => Hello
    [6] => fri
    [10] => nd
    [14] => you're
    [29] => looking
    [46] => good
    [51] => today
)

Array
(
    [0] => Hello
    [1] => fri3nd
    [2] => you're
    [3] => looking
    [4] => good
    [5] => today
)

7

Siehe auch

explode() - Teilt eine Zeichenkette anhand einer Zeichenkette
preg_split() - Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks
count_chars() - Gibt Informationen über die in einem String enthaltenen Zeichen zurück
substr_count() - Ermittelt, wie oft eine Zeichenkette in einem String vorkommt