CKTIS / PHP
strlen: Zeichenkettenlänge in Bytes
strlen zählt die Bytes einer PHP-Zeichenkette, nicht die sichtbaren Zeichen. Das misst die Datenmenge, aber nicht immer die Textlänge aus Sicht des Nutzers.
Version: PHP 8.4
Syntax
strlen(string $string): intstrlen("ABC") ergibt 3, eine leere Zeichenkette hat die Länge 0. Leerzeichen und Nullbytes zählen ebenfalls. PHP beendet eine Zeichenkette nicht am ersten Nullbyte, deshalb ergibt strlen("A\0B") den Wert 3.
In UTF-8 belegt der Buchstabe é zwei Bytes. Ähnlich aussehender Text aus e und einem getrennten Akzent belegt drei. Bytes, Unicode-Codepunkte und Graphemcluster sind unterschiedliche Maße; strlen allein prüft nicht die Gültigkeit der Kodierung.
Im Beispiel verhindert declare(strict_types=1), dass Zahlen implizit anstelle einer Zeichenkette angenommen werden. Ein ungültiger Typ führt zu TypeError. Prüfe den Eingabetyp, statt anzunehmen, jeder Wert werde von selbst zu Text.
Verwende strlen für Bytegrenzen. Entscheide bei Textgrenzen, ob du Codepunkte oder vom Nutzer wahrgenommene Zeichen meinst. mb_strlen benötigt die Erweiterung mbstring und akzeptiert ein Kodierungsargument; gib UTF-8 an, wenn die Eingabe so kodiert ist. grapheme_strlen benötigt intl und gültige UTF-8-Eingaben, hat aber keinen Kodierungsparameter. Das Beispiel funktioniert ohne diese Erweiterungen und misst bewusst nur Bytes.
Beispiele
<?php
declare(strict_types=1);
echo strlen(""), " ", strlen("A\0B"), "\n";
echo strlen("\u{00E9}"), " ", strlen("e\u{0301}"), "\n";
try {
strlen(42);
} catch (TypeError $error) {
echo "TypeError\n";
}
Ergebnis
0 3 2 3 TypeError