Arr('H', 'e', 'l', 'l', 'o', ',', ' ', 'W', 'o', 'r', 'l', 'd') * * Str\chunk('PHP', 3) * => Arr('PHP') * * Str\chunk('مرحبا') * => Arr('م', 'ر', 'ح', 'ب', 'ا') * * Str\chunk('مرحبا', 2) * => Arr('مر', 'حب', 'ا') * * @param int<1, 65535> $chunk_length maximum length of the chunk * * @return list if $chunk_length parameter is specified, the returned array will be broken down * into chunks with each being $chunk_length in length, otherwise each chunk will be * one character in length. * If the $chunk_length length exceeds the length of string, the entire string is returned * as the first (and only) array element. * * @pure */ function chunk(string $string, int $chunk_length = 1, Encoding $encoding = Encoding::UTF_8): array { if ('' === $string) { return []; } /** @var list */ return mb_str_split($string, $chunk_length, $encoding->value); }