array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.mb-substr.php', 1 => 'mb_substr', 2 => 'Extrae una subcadena', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Funciones de strings multibyte', ), 'prev' => array ( 0 => 'function.mb-substitute-character.php', 1 => 'mb_substitute_character', ), 'next' => array ( 0 => 'function.mb-substr-count.php', 1 => 'mb_substr_count', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mbstring/functions/mb-substr.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_substr

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_substr — Extrae una subcadena

Descripción

function mb_substr(
    string $string,
    int $start,
    ?int $length = null,
    ?string $encoding = null
): string

Realiza una operación similar a substr() basada en el número de caracteres. La posición se cuenta desde el inicio de la string string. La posición del primer carácter es 0, el segundo, uno, etc...

Parámetros

string

La cadena desde la cual extraer la subcadena.

start

Si start es positivo, la cadena devuelta comenzará en el carácter número start, dentro de la cadena string. El primer carácter está numerado cero. En efecto, en la cadena 'abcdef', el carácter en la posición 0 es 'a', el carácter en la posición 2 es 'c', y así sucesivamente.

Si start es negativo, la cadena devuelta comenzará en el carácter número start contando desde el final de la cadena string.

length

Número máximo de caracteres a utilizar desde string. Si este parámetro es omitido, o vale NULL, todos los caracteres hasta el final de la cadena serán extraídos.

encoding
El parámetro encoding es la codificación de caracteres. Si se omite o es null, se utilizará el valor de la codificación de caracteres interna.

Valores devueltos

mb_substr() devuelve la porción de la cadena string que comienza en el carácter start y tiene una longitud de length caracteres.

Historial de cambios

Versión Descripción
8.4.0 En cadenas inválidas (aquellas con errores de codificación), los índices de caracteres ahora se interpretan de la misma manera que la mayoría de las otras funciones de mbstring. Esto significa que los índices de caracteres devueltos por mb_strpos() pueden pasarse directamente.
8.0.0 encoding ahora acepta null.

Ver también