Función PHP preg_filter()
Ejemplo
Envuelva los números entre paréntesis en una lista de cadenas:
<?php
$input = [
"It is 5 o'clock",
"40 days",
"No
numbers here",
"In the year 2000"
];
$result =
preg_filter('/[0-9]+/', '($0)', $input);
print_r($result);
?>
Definición y uso
La preg_filter()
función devuelve una cadena o matriz de cadenas en las que las coincidencias del patrón se han reemplazado con la cadena de reemplazo.
Si la entrada es una matriz, esta función devuelve una matriz. Si la entrada es una cadena, esta función devuelve una cadena.
Esta función es similar a preg_replace()
con una diferencia: cuando no se encuentra una coincidencia para el patrón en una cadena de entrada, la cadena no se utilizará en el valor de retorno. En este escenario, si la entrada es una cadena en lugar de una matriz, la función devuelve nulo .
Las cadenas de reemplazo pueden contener referencias inversas en la forma \n o $n, donde n es el índice de un grupo en el patrón. En la cadena devuelta, las instancias de \n y $n se reemplazarán con la subcadena que coincidió con el grupo o, si se usan \0 o $0, con la expresión completa.
Sintaxis
preg_filter(pattern, replacement, input, limit, count)
Valores paramétricos
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
replacement | Required. A string which will replace the matched patterns. It may contain backreferences |
input | Required. A string or array of strings in which the replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Detalles técnicos
Valor devuelto: | Devuelve una matriz de cadenas reemplazadas si la entrada era una matriz, una cadena con reemplazos realizados si la entrada era una cadena o nulo si la entrada era una cadena y no se encontraron coincidencias. |
---|---|
Versión PHP: | 5.3.0 |
❮ Referencia PHP RegExp