Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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): int

Dla 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

Źródła