Resumo : neste tutorial, você aprenderá como usar a strlen()
função PHP para obter o comprimento de uma string.
Introdução à função PHP strlen()
A strlen()
função retorna o comprimento de uma string especificada . Aqui está a sintaxe da strlen()
função:
strlen ( string $string ) : int
Linguagem de código: PHP ( php )
A strlen()
função possui um parâmetro $string
, que é a string para medir o comprimento. A strlen()
função retorna o comprimento em $string
bytes ou zero se $string
estiver vazio.
É importante observar que a strlen()
função retorna o número de bytes em vez do número de caracteres. Se cada caractere tiver 1 byte, o número de bytes será igual ao número de caracteres.
Entretanto, se você lidar com strings multibyte, por exemplo, UTF-8, o número de bytes será maior que o número de caracteres.
Para obter o número de caracteres em uma string multibyte, você deve usar a mb_strlen()
função:
mb_strlen ( string $string , string|null $encoding = null ) : int
Linguagem de código: PHP ( php )
A mb_strlen()
função possui um adicional $encoding
que especifica a codificação de caracteres do arquivo $string
.
A mb_strlen()
função retorna o número de caracteres do $string
caractere $encoding
. O mb_strlen()
retorna um para cada caractere multibyte.
Exemplos de funções PHP strlen()
Vejamos alguns exemplos de uso da strlen()
função.
1) Exemplo simples de função strlen()
O exemplo a seguir usa a strlen()
função para retornar o comprimento da string PHP:
<?php
$str = 'PHP';
echo strlen($str); // 3
Linguagem de código: PHP ( php )
2) Usando strlen() com uma string multibyte
A sequência multibyte a seguir possui cinco caracteres. No entanto, seu tamanho é de 15 bytes.
'こんにちは'
Linguagem de código: PHP ( php )
A propósito, こんにちは é uma saudação em japonês. Significa olá em inglês.
A strlen()
função retorna 15 bytes para a string 'こんにちは'
:
<?php
$message = 'こんにちは';
echo strlen($message); // 15 bytes
Linguagem de código: PHP ( php )
Saída:
15
Linguagem de código: PHP ( php )
Mas a mb_strlen()
função retorna cinco caracteres para essa string:
<?php
$message = 'こんにちは';
echo mb_strlen($message); // 5 characters
Linguagem de código: PHP ( php )
Saída:
5
Linguagem de código: PHP ( php )
Resumo
- Use a função PHP
strlen()
para obter o número de bytes de uma string. - Use a função PHP
mb_strlen()
para obter o número de caracteres em uma string com uma codificação específica.