(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strcut — Получение части строки
$string
,$start
,$length
= null
,$encoding
= null
mb_strcut() вырезает подстроку из строки также, как mb_substr(), но оперирует байтами вместо символов. Если начало вырезаемой части попадает между байтами одного символа, функция вырежет подстроку, начиная с первого байта этого символа. Это существенное отличие от substr(), которая просто вырежет подстроку, начиная с середины символа, и нарушит тем самым последовательность байт в строке.
string
Исходная строка.
start
Если start
не отрицательное, возвращённая строка
начнётся с позиции start
в байтах
от начала string
, начальный байт имеет индекс 0.
К примеру, в строке 'abcdef
', байт в позиции 0
- это
'a
', байт в позиции 2
- 'c
' и т.д.
Если start
отрицательное, возвращаемая строка
будет начинаться с байта start
с обратным отсчётом от конца string
. Однако, если
величина отрицательного start
превышает
длину строки, возвращаемая часть начнётся с начала
string
.
length
Длина подстроки в байтах bytes. Если не указана, то
передаётся NULL
и вырезаются все байты до конца строки.
Если length
отрицательное, возвращаемая строка будет
заканчиваться байтом length
с обратным отсчётом от
конца string
. Однако если величина отрицательного значения
length
превышает число символов
после позиции start
, будет возвращена пустая строка.
encoding
Параметр encoding
представляет собой символьную кодировку. Если он опущен или равен null
, вместо него будет использовано значение внутренней кодировки.
mb_strcut() возвращает часть строки
string
, заданную аргументами
start
и length
.
Версия | Описание |
---|---|
8.0.0 |
Теперь параметр encoding может принимать значение null .
|