array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.mb-ereg-replace-callback.php', 1 => 'mb_ereg_replace_callback', 2 => 'Buscar y reemplazar mediante expresión regular con soporte multi byte utilizando una función de devolución de llamada', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Funciones de strings multibyte', ), 'prev' => array ( 0 => 'function.mb-ereg-replace.php', 1 => 'mb_ereg_replace', ), 'next' => array ( 0 => 'function.mb-ereg-search.php', 1 => 'mb_ereg_search', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mbstring/functions/mb-ereg-replace-callback.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_ereg_replace_callback

(PHP 5 >= 5.4.1, PHP 7, PHP 8)

mb_ereg_replace_callback — Buscar y reemplazar mediante expresión regular con soporte multi byte utilizando una función de devolución de llamada

Descripción

mb_ereg_replace_callback(
    string $pattern,
    callable $callback,
    string $string,
    ?string $options = null
): string|false|null

Busca los string que coinciden con el argumento pattern, luego reemplaza los textos que coinciden con el retorno de la función callback.

El comportamiento de esta función es casi idéntico a mb_ereg_replace(), a excepción de que el argumento replacement debe especificar una función de devolución de llamada callback.

Parámetros

pattern

La expresión regular.

Los caracteres multi byte pueden ser utilizados en el pattern.

callback

Un callback que será llamado y se le pasará un array de elementos coincidentes en la cadena de caracteres string. El callback debe retornar la cadena reemplazada.

Con frecuencia será necesario utilizar la función callback para mb_ereg_replace_callback() solo una vez. En este caso se pueden utilizar las funciones anónimas para declarar una función de devolución de llamada al momento de llamar a la función mb_ereg_replace_callback(). Al hacerlo de esta manera se tiene toda la información necesaria para la llamada de la función en un solo lugar, lo que permite evitar saturar el espacio de nombres de las funciones con un callback de función que no se utiliza en otro lugar.

string

El string que debe ser verificado.

options

La opción de búsqueda. Para más explicaciones, consulte mb_regex_set_options().

Valores devueltos

Retorna un string en caso de éxito, o false en caso de error. Si string no es válido para el codificación actual, null es retornado.

Historial de cambios

Versión Descripción
8.0.0 options ahora es nullable.
7.1.0 Esta función verifica si string es válido para la codificación actual.

Ejemplos

Ejemplo #1 Ejemplo con mb_ereg_replace_callback()

<?php
// este texto fue utilizado en 2002
// se desea actualizarlo para 2003
$text = "April fools day is 04/01/2002\n";
$text.= "Last christmas was 12/24/2001\n";
// la función de devolución de llamada
function next_year($matches)
{
// como de costumbre: $matches[0] es la coincidencia completa
// $matches[1] la coincidencia para el primer subpatrón
// encerrado en '(...)' y así sucesivamente
return $matches[1].($matches[2]+1);
}
echo mb_ereg_replace_callback(
"(\d{2}/\d{2}/)(\d{4})",
"next_year",
$text);

?>

El ejemplo anterior mostrará:

April fools day is 04/01/2003
Last christmas was 12/24/2002

Ejemplo #2 mb_ereg_replace_callback() utilizando funciones anónimas

<?php
// este texto fue utilizado en 2002
// se desea actualizarlo para 2003
$text = "April fools day is 04/01/2002\n";
$text.= "Last christmas was 12/24/2001\n";

echo mb_ereg_replace_callback(
"(\d{2}/\d{2}/)(\d{4})",
function ($matches) {
return $matches[1].($matches[2]+1);
},
$text);
?>

Notas

Nota:

La codificación interna o la codificación de caracteres especificada por mb_regex_encoding() se utilizará como codificación de caracteres para esta función.

Ver también