array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.xdiff-string-patch.php', 1 => 'xdiff_string_patch', 2 => 'Altera uma string com uma correção unificada', ), 'up' => array ( 0 => 'ref.xdiff.php', 1 => 'Funções de xdiff', ), 'prev' => array ( 0 => 'function.xdiff-string-merge3.php', 1 => 'xdiff_string_merge3', ), 'next' => array ( 0 => 'function.xdiff-string-patch-binary.php', 1 => 'xdiff_string_patch_binary', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/xdiff/functions/xdiff-string-patch.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

xdiff_string_patch

(PECL xdiff >= 0.2.0)

xdiff_string_patch — Altera uma string com uma correção unificada

Descrição

xdiff_string_patch(
    string $str,
    string $patch,
    int $flags = ?,
    string &$error = ?
): string

Corrige uma string str com uma correção unificada no parâmetro patch e retorna o resultado. patch deve ser uma correção unificada criada pela função xdiff_file_diff()/xdiff_string_diff(). Um parâmetro opcional flags especifica o modo de operação. Quaisquer partes rejeitadas da correção serão armazenadas dentro da variável error se forem fornecidas.

Parâmetros

str

A string original.

patch

A string de correção unificada. Ela deve ser criada usando as funções xdiff_string_diff(), xdiff_file_diff() ou ferramentas compatíveis.

flags

flags podem ser XDIFF_PATCH_NORMAL (modo padrão, correção normal) ou XDIFF_PATCH_REVERSE (correção reversa).

A partir da versão 1.5.0, também pode-se usar a operação binária OR para habilitar o sinalizador XDIFF_PATCH_IGNORESPACE.

error

Se fornecido, as partes rejeitadas serão armazenadas dentro desta variável.

Valor Retornado

Retorna a string corrigida ou false em caso de erro.

Exemplos

Exemplo #1 Exemplo de xdiff_string_patch()

O código a seguir aplica alterações a alguns artigos.

<?php
$old_article = file_get_contents('./old_article.txt');
$diff = $_SERVER['patch']; /* Digamos que alguém colou uma correção em um formulário HTML */

$errors = '';

$new_article = xdiff_string_patch($old_article, $diff, XDIFF_PATCH_NORMAL, $errors);
if (is_string($new_article)) {
echo "Novo artigo:\n";
echo $new_article;
}

if (strlen($errors)) {
echo "Rejeições: \n";
echo $errors;
}

?>

Veja Também