CKTIS / PHP
strlen: comprimento de uma cadeia em bytes
strlen conta os bytes de uma cadeia PHP, não os caracteres visíveis no ecrã. Mede o volume dos dados, mas nem sempre o comprimento do texto para o utilizador.
Versão: PHP 8.4
Sintaxe
strlen(string $string): intstrlen("ABC") dá 3 e uma cadeia vazia tem comprimento 0. Os espaços e o byte nulo também contam. O PHP não termina uma cadeia no primeiro byte nulo, pelo que strlen("A\0B") dá 3.
Em UTF-8, a letra é ocupa dois bytes. Um texto de aspeto semelhante composto por e e um acento separado ocupa três. Bytes, pontos de código Unicode e grafemas são medidas diferentes; strlen, por si só, não valida a codificação.
No exemplo, declare(strict_types=1) impede a aceitação implícita de números em vez de uma cadeia. Um tipo inválido provoca TypeError. Verifica o tipo da entrada em vez de presumires que todos os valores se transformarão sozinhos em texto.
Usa strlen para limites em bytes. Para limites de texto, decide se pretendes pontos de código ou caracteres percebidos pelo utilizador. mb_strlen exige a extensão mbstring e aceita um argumento de codificação; indica UTF-8 se essa for a codificação da entrada. grapheme_strlen exige intl e uma entrada UTF-8 válida, mas não tem parâmetro de codificação. O exemplo funciona sem estas extensões e mede deliberadamente apenas bytes.
Exemplos
<?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";
}
Resultado
0 3 2 3 TypeError