Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes