CKTIS / PHP
strlen: de lengte van een string in bytes
strlen telt de bytes van een PHP-string, niet de tekens die je op het scherm ziet. Dat meet de gegevensomvang, maar niet altijd de tekstlengte voor de gebruiker.
Versie: PHP 8.4
Syntax
strlen(string $string): intstrlen("ABC") geeft 3 en een lege string heeft lengte 0. Spaties en een nulbyte tellen ook mee. PHP beëindigt een string niet bij de eerste nulbyte, dus strlen("A\0B") geeft 3.
In UTF-8 neemt de letter é twee bytes in. Vergelijkbaar ogende tekst met e en een afzonderlijk accent neemt er drie in. Bytes, Unicode-codepunten en grafeemclusters zijn verschillende maten; strlen controleert op zichzelf niet of de codering geldig is.
In het voorbeeld voorkomt declare(strict_types=1) dat getallen impliciet worden geaccepteerd waar een string nodig is. Een ongeldig type veroorzaakt TypeError. Controleer het invoertype in plaats van aan te nemen dat elke waarde vanzelf tekst wordt.
Gebruik strlen voor bytelimieten. Bepaal bij tekstlimieten of je codepunten of door gebruikers waargenomen tekens bedoelt. mb_strlen vereist de extensie mbstring en accepteert een coderingsargument; geef UTF-8 op als de invoer zo is gecodeerd. grapheme_strlen vereist intl en geldige UTF-8-invoer, maar heeft geen coderingsparameter. Het voorbeeld werkt zonder deze extensies en meet bewust alleen bytes.
Voorbeelden
<?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";
}
Resultaat
0 3 2 3 TypeError