База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

strlen: дължина на низ в байтове

strlen брои байтовете на PHP низ, а не видимите на екрана знаци. Това измерва размера на данните, но не винаги дължината на текста за потребителя.

Версия: PHP 8.4

Синтаксис

strlen(string $string): int

strlen("ABC") дава 3, а празен низ има дължина 0. Интервалите и нулевият байт също се броят. PHP не прекратява низ при първия нулев байт, затова strlen("A\0B") дава 3.

В UTF-8 буквата é заема два байта. Подобно изглеждащ текст от e и отделен акцент заема три. Байтове, кодови точки Unicode и графеми са различни мерки; самостоятелно strlen не проверява валидността на кодирането.

В примера declare(strict_types=1) забранява неявното приемане на числа вместо низ. Невалиден тип предизвиква TypeError. Проверявай типа на входа, вместо да приемаш, че всяка стойност сама ще се превърне в текст.

Използвай strlen за ограничения в байтове. За текстови ограничения определи дали имаш предвид кодови точки или знаци, възприемани от потребителя. mb_strlen изисква разширението mbstring и приема аргумент за кодиране; посочи UTF-8, ако това е кодирането на входа. grapheme_strlen изисква intl и валиден вход в UTF-8, но няма параметър за кодиране. Примерът работи без тези разширения и нарочно измерва само байтове.

Примери

<?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";
}

Резултат

0 3
2 3
TypeError

Източници