(PHP 7 >= 7.4.0, PHP 8)
mb_str_split — マルチバイト文字列を受取り、文字の配列を返す
この関数は文字列の配列を返します。
これは str_split() に 1, 2 または 4バイトの固定長のエンコーディングだけでなく、
可変長のエンコーディングのサポートも追加したものです。
length を指定すると、
文字列は指定された数の(バイトではなく)文字のチャンクに分割されます。
encoding もオプションで指定できますが、
指定するほうが良いでしょう。
string文字またはチャンクに分割する string
lengthこれを指定すると、返される配列の個々の要素は一文字ではなく複数の文字になります。
encodingencoding
パラメータには文字エンコーディングを指定します。省略した場合、もしくは null の場合は、
内部文字エンコーディングを使用します。
サポートされているエンコーディング のうち、ひとつを指定した文字列
mb_str_split() は、string の配列を返します。
| バージョン | 説明 |
|---|---|
| 8.0.0 |
encoding は、nullable になりました。
|
| 8.0.0 |
この関数は、失敗時に false を返さなくなりました。
|
if( !function_exists('mb_str_split')){ function mb_str_split( $string = '', $length = 1 , $encoding = null ){ if(!empty($string)){ $split = array(); $mb_strlen = mb_strlen($string,$encoding); for($pi = 0; $pi < $mb_strlen; $pi += $length){ $substr = mb_substr($string, $pi,$length,$encoding); if( !empty($substr)){ $split[] = $substr; } } } return $split; }}Note: function return NULL if can't convert argument type.Polyfill PHP < 7.4 based on package "symfony/polyfill-mbstring":<?phpfunction mb_str_split($string, $split_length = 1, $encoding = null){ if (null !== $string && !\is_scalar($string) && !(\is_object($string) && \method_exists($string, '__toString'))) { trigger_error('mb_str_split(): expects parameter 1 to be string, '.\gettype($string).' given', E_USER_WARNING); return null; } if (null !== $split_length && !\is_bool($split_length) && !\is_numeric($split_length)) { trigger_error('mb_str_split(): expects parameter 2 to be int, '.\gettype($split_length).' given', E_USER_WARNING); return null; } $split_length = (int) $split_length; if (1 > $split_length) { trigger_error('mb_str_split(): The length of each segment must be greater than zero', E_USER_WARNING); return false; } if (null === $encoding) { $encoding = mb_internal_encoding(); } else { $encoding = (string) $encoding; } if (! in_array($encoding, mb_list_encodings(), true)) { static $aliases; if ($aliases === null) { $aliases = []; foreach (mb_list_encodings() as $encoding) { $encoding_aliases = mb_encoding_aliases($encoding); if ($encoding_aliases) { foreach ($encoding_aliases as $alias) { $aliases[] = $alias; } } } } if (! in_array($encoding, $aliases, true)) { trigger_error('mb_str_split(): Unknown encoding "'.$encoding.'"', E_USER_WARNING); return null; } } $result = []; $length = mb_strlen($string, $encoding); for ($i = 0; $i < $length; $i += $split_length) { $result[] = mb_substr($string, $i, $split_length, $encoding); } return $result;}?>