(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strcut — Corta una parte de string
mb_strcut() extrae un substring desde un string, de manera similar a la función mb_substr(), pero opera sobre los bytes en lugar de los caracteres. Si el corte ocurre entre 2 bytes de un carácter multibyte, el corte se realizará al inicio del primer byte de ese carácter. Esta es también la diferencia con la función substr() que cortará el string en medio de los bytes, resultando en una secuencia de bytes mal formada.
string
El string a cortar.
start
Si start
es positivo, el string
devuelto comenzará en el byte número start
,
en el string string
. El primer carácter
está numerado cero. En efecto, en el string 'abcdef
',
el byte en la posición 0
es 'a
',
el byte en la posición 2
es 'c
',
y así sucesivamente.
Si start
es negativo, el string devuelto
comenzará en el byte número start
contando
desde el final del string string
. Sin embargo, si el
número negativo pasado como argumento start
es mayor
que la longitud del string, la porción devuelta comenzará desde
el inicio del string string
.
length
Longitud en bytes. Si este
argumento es omitido, o vale NULL
,
todos los bytes hasta el final del string serán extraídos.
Si length
es negativo, el string devuelto
terminará en la posición length
contando
desde el final del string string
.
Sin embargo, si el número negativo pasado al argumento
length
es mayor que el número de caracteres
después de la posición start
, un string vacío será
devuelto.
encoding
El parámetro encoding
es la codificación de caracteres. Si es omitido o null
, será usado el valor de la
codificación de caracteres interna.
mb_strcut() devuelve la porción del string
string
que comienza en el carácter
start
y tiene la longitud de
length
caracteres.
Versión | Descripción |
---|---|
8.0.0 |
encoding ahora es nullable.
|