Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

strlen("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

Zdroje