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): intstrlen("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