PHP 8.4.6 Released!

grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_splitSépare une chaîne en un tableau

Description

grapheme_str_split(string $string, int $length = 1): array|false

Cette fonction renvoie un tableau de chaînes, c'est une version de str_split() avec le support des caractères de cluster de graphèmes. Si le paramètre length est spécifié, la chaîne est séparée en morceaux de la longueur spécifiée en clusters de graphèmes (pas en octets).

Liste de paramètres

string

La string à séparer en clusters de graphèmes ou en morceaux. string doit être un UTF-8 valide.

length

Chaque élément du tableau renvoyé sera composé de length clusters de graphèmes.

Valeurs de retour

grapheme_str_split() renvoie un tableau de chaînes, ou false si une erreur survient.

Erreurs / Exceptions

Si string n'est pas une chaîne de caractères valide, une ValueError sera lancée.

Voir aussi

add a note

User Contributed Notes 1 note

up
0
cygx1 at blackhole dot io
1 day ago
Here is a userland implementation that can be included in code that needs to support PHP 8.3 and below:

<?php

if (!function_exists('grapheme_str_split')) {
function
grapheme_str_split(string $string, int $length = 1): array|false
{
if (
$length < 1) {
throw new
\ValueError('Argument #2 ($length) must be greater than 0 and less than or equal to 1073741823');
}

try {
return
preg_split('/(\X{' . $length . '})/u', $string, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
} catch (
\Throwable $e) {
return
false;
}
}
}

?>
To Top