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

CKTIS / PHP

mb_strlen()

A função mb_strlen conta caracteres na codificação indicada e null seleciona a interna.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

mb_strlen(string $string, ?string $encoding = null): int

A função mb_strlen conta caracteres na codificação indicada e null seleciona a interna. Em UTF-8 conta pontos de código, pelo que uma marca combinante e a sua base contam separadamente mesmo formando uma letra visível. Uma cadeia vazia mede zero. Uma codificação desconhecida lança ValueError em PHP 8.4.

Assinatura

mb_strlen(string $string, ?string $encoding = null): int

Saída do exemplo

[2,3,1,0]
ValueError

Exemplos

<?php
$s = "e\u{0301}";
echo json_encode([mb_strlen($s, "UTF-8"), strlen($s), mb_strlen("é", "UTF-8"), mb_strlen("", "UTF-8")]), PHP_EOL;
try { mb_strlen("x", "not_an_encoding"); } catch (ValueError $e) { echo get_class($e); }

Resultado

[2,3,1,0]
ValueError

Fontes