CKTIS / PHP
strlen: długość napisu w bajtach
strlen liczy bajty napisu PHP, nie znaki widziane na ekranie. To właściwy pomiar rozmiaru danych, ale nie zawsze długości tekstu dla użytkownika.
Wersja: PHP 8.4
Składnia
strlen(string $string): intDla strlen("ABC") wynikiem jest 3, a dla pustego napisu 0. Spacje i bajt zerowy również są liczone. PHP nie kończy napisu na pierwszym bajcie zerowym, więc strlen("A\0B") daje 3.
W UTF-8 litera é zajmuje dwa bajty. Podobnie wyglądający tekst złożony z litery e i osobnego akcentu zajmuje trzy. Liczba bajtów, punktów kodowych Unicode i grafemów to różne miary; sam strlen nie sprawdza poprawności kodowania.
W przykładzie declare(strict_types=1) wyłącza niejawne przyjmowanie liczb zamiast napisu. Niepoprawny typ powoduje TypeError. Sprawdź typ danych wejściowych, zamiast liczyć na to, że każda wartość sama zmieni się w tekst.
Przy limitach bajtów używaj strlen. Przy limitach tekstu określ, czy chodzi o punkty kodowe, czy znaki postrzegane przez użytkownika. mb_strlen wymaga rozszerzenia mbstring i przyjmuje argument kodowania; podaj UTF-8, jeśli tak zakodowano dane wejściowe. grapheme_strlen wymaga rozszerzenia intl i poprawnego wejścia UTF-8, ale nie ma parametru kodowania. Przykład działa bez tych rozszerzeń i celowo mierzy wyłącznie bajty.
Przykłady
<?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";
}
Wynik
0 3 2 3 TypeError