mb_str_split

(PHP 7 >= 7.4.0, PHP 8)

mb_str_split — Belirtilen çok baytlı dizgenin karakterlerini içeren bir dizi döndürür

Açıklama

mb_str_split(string $dizge, int $uzunluk = 1, ?string $kodlama = null): array

Bir dizgeler dizisi döndürür. 1, 2, veya 4 baytlık sabit boyutlular yanında değişken karakter boyutlu kodlamaları da destekleyen bir str_split() sürümüdür. uzunluk belirtilmişse dizge belirtilen bayt uzunlukta parçalara bölünür. kodlama belirtilmese de olur.

Bağımsız Değişkenler

dizge

Karakterleri ayrıştırılacak dizge.

uzunluk

Belirtilirse, dönen dizinin her elemanı tek baytlık karakterler değil, çok baytlı karakterler içerir.

kodlama

kodlama bağımsız değişkeninde karakter kodlaması belirtilir. Belirtilmediği takdirde veya null ise dahili karakter kodlaması kullanılır.

Desteklenen kodlamalardan birini içeren bir dizge.

Dönen Değerler

mb_str_split() dizge dizisi döndürür.

Sürüm Bilgisi

Sürüm:	Açıklama
8.0.0	`kodlama` artık `null` olabiliyor.
8.0.0	Başarısızlık durumunda artık `false` dönmüyor.

Ayrıca Bakınız

str_split() - Bir dizgeyi bir diziye dönüştürür

add a note

User Contributed Notes 3 notes

down

webmaster at redinfo dot co dot kr ¶

2 years ago


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;
    }
}

down

info at ensostudio dot ru ¶

4 years ago


Note: function return NULL if can't convert argument type.

Polyfill PHP < 7.4 based on package "symfony/polyfill-mbstring":
<?php
function 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;
}
?>

down

-6

vovan-ve at yandex dot ru ¶

4 years ago


Lazy polyfill for UTF-8 only:

function utf8_str_split(string $input, int $splitLength = 1)
{
    $re = \sprintf('/\\G.{1,%d}+/us', $splitLength);
    \preg_match_all($re, $input, $m);
    return $m[0];
}

add a note