Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / PHP

strlen: dolžina niza v bajtih

strlen šteje bajte niza PHP, ne znakov, vidnih na zaslonu. S tem meri velikost podatkov, ne pa vedno dolžine besedila, kot jo dojema uporabnik.

Različica: PHP 8.4

Sintaksa

strlen(string $string): int

strlen("ABC") vrne 3, prazen niz pa ima dolžino 0. Štejejo tudi presledki in ničelni bajt. PHP niza ne konča pri prvem ničelnem bajtu, zato strlen("A\0B") vrne 3.

V UTF-8 črka é zavzame dva bajta. Podobno besedilo, sestavljeno iz e in ločenega naglasa, zavzame tri. Bajti, kodne točke Unicode in grafemi so različne mere; sam strlen ne preverja veljavnosti kodiranja.

V primeru declare(strict_types=1) prepreči implicitno sprejemanje števil namesto niza. Neveljaven tip povzroči TypeError. Preveri tip vhoda, namesto da bi predpostavljal, da se vsaka vrednost sama spremeni v besedilo.

Za omejitve v bajtih uporabi strlen. Pri omejitvah besedila določi, ali misliš kodne točke ali znake, kot jih zazna uporabnik. mb_strlen zahteva razširitev mbstring in sprejme argument za kodiranje; navedi UTF-8, če je vhod tako kodiran. grapheme_strlen zahteva intl in veljaven vhod UTF-8, nima pa parametra za kodiranje. Primer deluje brez teh razširitev in namenoma meri samo bajte.

Primeri

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

Rezultat

0 3
2 3
TypeError

Viri