|
(PHP 3 >= 3.0.9, PHP 4, PHP 5)
preg_replace -- Realizar una operación de búsqueda y reemplazo con expresiones regularesBusca en asunto por coincidencias con patron y las reemplaza con reemplazo.
reemplazo puede contener referencias de la forma \\n o (desde PHP 4.0.4) $n, siendo éste último estilo el más recomendable. Cada referencia de este tipo será reemplazada con el texto capturado por el nésimo patrón entre paréntesis. n puede ser un valor de 0 a 99, y \\0 o $0 hacen referencia al texto coincidente con el patrón completo. Los paréntesis de apertura son contados de izquierda a derecha (comenzando en 1) para obtener el número del sub-patrón de captura.
Cuando se trabaja con un patrón de reemplazo en donde una referencia hacia atrás está inmediatamente seguida por otro número (es decir, se coloca un número literal inmediatamente después de un patrón coincidente), no es posible usar la familiar notación \\1 para la referencia hacia atrás. \\11, por ejemplo, confundiría a preg_replace() ya que no es claro si se desea la referencia hacia atrás \\1 seguida de un 1 literal, o la referencia hacia atrás \\11 seguida por nada. En este caso la solución es usar \${1}1. Esto crea una referencia hacia atrás separada $1, dejando el 1 como una secuencia literal.
Si asunto es una matriz, entonces la operación de búsqueda y reemplazo se realiza sobre cada entrada de asunto, y el valor de retorno es una matriz también.
El modificador e hace que preg_replace() trate el parámetro reemplazo como código PHP después de que las sustituciones de referencias correspondientes son realizadas. Consejo: asegúrese de que reemplazo constituya una cadena de código PHP válido, de otra forma PHP se quejará sobre un error de análisis sintáctico en la línea que contiene la llamada a preg_replace().
El patrón a buscar. Puede ser una cadena o una matriz con cadenas.
La cadena o una matriz con las cadenas de reemplazo. Si este parámetro es una cadena y el parámetro patron es una matriz, todos los patrones serán reemplazados por esa cadena. Si tanto patron como reemplazo son matrices, cada patron será reemplazado por su contraparte en reemplazo. Si hay menos claves en la matriz reemplazo que en la matriz patron, los patrones excedentes serán reemplazados con una cadena vacía.
La cadena o una matriz con cadenas para buscar y reemplazar.
La cantidad máxima posible de reemplazos para cada patrón en cada cadena asunto. Su valor predeterminado es -1 (sin límite).
Si se especifica, esta variables será llenada con el número de reemplazos realizados.
preg_replace() devuelve una matriz si el parámetro asunto es una matriz, o una cadena de lo contrario.
Si se encuentran coincidencias, el nuevo asunto será devuelto, de otra forma asunto será devuelto intacto.
Ejemplo 3. Uso de matrices indexadas con preg_replace()
El resultado del ejemplo seria:
Ordenando por clave los patrones y reemplazos, podemos obtener lo que queríamos.
El resultado del ejemplo seria:
|
Nota: Cuando se usan matrices con patron y reemplazo, las claves son procesadas en el orden en que aparecen en la matriz. Esto no es necesariamente lo mismo que el orden de índices numéricos. Si usan índices para identificar cuál patron debería ser reemplazado por cuál reemplazo, debería usar ksort() sobre cada matriz antes de llamar preg_replace().
Hosting by: hurra.com
Generated: 2007-01-26 18:01:05