Updated PHP Windows builds for Brotli security fix

grapheme_strlen

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

grapheme_strlen — Lee la longitud de una cadena en número de grafemas

Descripción

Estilo procedimental

function grapheme_strlen(string $string): int|false|null

Lee la longitud de una cadena en número de grafemas (y no en bytes o caracteres).

Parámetros

string

La cadena a medir. Debe ser una cadena UTF-8 válida.

Valores devueltos

La longitud de la cadena en caso de éxito, null o false en caso de fallo.

Ejemplos

Ejemplo #1 Ejemplo con grapheme_strlen()

<?php

$char_a_ring_nfd = "a\xCC\x8A";  // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forma normalizada "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forma normalizada "D"

print grapheme_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd);

?>

El ejemplo anterior mostrará:

6

Ejemplo #2 Gestión de una entrada UTF-8 no válida

grapheme_strlen() devuelve null o false en caso de fallo, incluido cuando la entrada no es UTF-8 válido. Utilice intl_get_error_code() e intl_error_name() para obtener los detalles del error de ICU.

<?php

$string = "\xFF"; // secuencia de bytes UTF-8 no válida
$length = grapheme_strlen($string);

if (!is_int($length)) {
    $code = intl_get_error_code();
    printf("grapheme_strlen() falló: %s (%d)\n", intl_error_name($code), $code);
} else {
    echo $length, PHP_EOL;
}

?>

El ejemplo anterior mostrará:

grapheme_strlen() falló: U_INVALID_CHAR_FOUND (10)

Véase también

+add a note

User Contributed Notes 1 note

up
10
jonhoggg at gmail dot com
4 years ago
You can use grapheme_strlen() to count emojis as a single character:

<?php
    echo strlen('🏴󠁧󠁢󠁥󠁮󠁧󠁿'); //28 - oh no
    echo mb_strlen('🏴󠁧󠁢󠁥󠁮󠁧󠁿'); // - closer, but no
    echo grapheme_strlen('🏴󠁧󠁢󠁥󠁮󠁧󠁿'); //1 - Bingo
?>
To Top