Documentación offline PHP master

xdiff_string_patch

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

xdiff_string_patch

Parchear una cadena con un diff unificado

Descripción#

xdiff_string_patch(string $str, string $patch, [int $flags], [string $error]): string
```php

Parchea una cadena `str` con un parche unificado en parámetro `patch` y devuelve el resultado. `patch` tiene que ser un diff unificado creado por la función `xdiff_file_diff`/`xdiff_string_diff`. Un parámetro opcional `flags` especifica el modo de operación. Cualquier fragmento erróneo del parche será almacenado en el interior de la variable `error` si si esta es proporcionada.

## Parámetros

`str`  
La cadena original.

`patch`  
La cadena parche unificada. Esta tiene que ser creada utilizando las funciones `xdiff_string_diff`, `xdiff_file_diff` o herramientas compatibles.

`flags`  
`flags` uede ser `XDIFF_PATCH_NORMAL` (modo por defecto, parche normal) o `XDIFF_PATCH_REVERSE` (parche invertido).

A partir de la versión 1.5.0, también se puede utilizar binario OR para habilitar el indicador `XDIFF_PATCH_IGNORESPACE`.

`error`  
Si se proporciona entonces los fragmentos erróneos se almacenan dentro de esta variable.

## Valores devueltos

Devuelve la cadena parcheada, o `false` en caso de error.

## Ejemplos

Ejemplo de `xdiff_string_patch`

El siguiente código aplica cambios en algún artículo.

```php

Véase también#

xdiff_string_diff