CKTIS / PHP
strlen: délka řetězce v bajtech
strlen počítá bajty řetězce PHP, nikoli znaky viditelné na obrazovce. Měří velikost dat, ale ne vždy délku textu z pohledu uživatele.
Verze: PHP 8.4
Syntaxe
strlen(string $string): intstrlen("ABC") vrací 3 a prázdný řetězec má délku 0. Počítají se i mezery a nulový bajt. PHP neukončuje řetězec na prvním nulovém bajtu, takže strlen("A\0B") vrátí 3.
V UTF-8 zabírá písmeno é dva bajty. Podobně vypadající text složený z e a samostatného přízvuku zabírá tři. Bajty, kódové body Unicode a grafémy jsou různé míry; samotné strlen neověřuje platnost kódování.
V příkladu declare(strict_types=1) brání implicitnímu přijetí čísel místo řetězce. Neplatný typ vyvolá TypeError. Kontroluj typ vstupu, místo abys předpokládal, že se každá hodnota sama změní na text.
Pro limity v bajtech používej strlen. U textových limitů rozhodni, zda jde o kódové body, nebo znaky vnímané uživatelem. mb_strlen vyžaduje rozšíření mbstring a přijímá argument kódování; zadej UTF-8, pokud tak máš zakódovaný vstup. grapheme_strlen vyžaduje intl a platný vstup v UTF-8, ale nemá parametr kódování. Příklad funguje bez těchto rozšíření a záměrně měří pouze bajty.
Příklady
<?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";
}
Výsledek
0 3 2 3 TypeError